Security News
Highlights from the 2024 Rails Community Survey
A record 2,709 developers participated in the 2024 Ruby on Rails Community Survey, revealing key tools, practices, and trends shaping the Rails ecosystem.
The cssom npm package is a library for parsing CSS files and manipulating CSSOM (CSS Object Model). It allows users to parse CSS strings into a stylesheet object, manipulate CSS rules, and serialize CSS objects back to strings. It is useful for server-side processing of CSS files or for any environment where a DOM is not present.
Parsing CSS strings
This feature allows you to parse a string of CSS into a CSSOM object, which can then be manipulated or queried.
const CSSOM = require('cssom');
const cssText = 'body { font-size: 12px; }';
const parsedCSS = CSSOM.parse(cssText);
console.log(parsedCSS);
Manipulating CSS rules
After parsing CSS, you can manipulate the CSS rules, such as changing the font size from 12px to 14px in this example.
const CSSOM = require('cssom');
const cssText = 'body { font-size: 12px; }';
const parsedCSS = CSSOM.parse(cssText);
parsedCSS.cssRules[0].style.setProperty('font-size', '14px');
console.log(parsedCSS.toString());
Serializing CSSOM to string
This feature allows you to serialize the manipulated CSSOM back into a CSS string, which can then be used in a style tag or an external stylesheet.
const CSSOM = require('cssom');
const cssText = 'body { font-size: 12px; }';
const parsedCSS = CSSOM.parse(cssText);
parsedCSS.cssRules[0].style.setProperty('font-size', '14px');
const serializedCSS = parsedCSS.toString();
console.log(serializedCSS);
jsdom is a JavaScript implementation of many web standards, including the DOM and the HTML standards. It allows for the parsing and manipulation of HTML and CSS documents in Node.js. Compared to cssom, jsdom provides a more complete simulation of a web browser's environment, including both HTML and CSS parsing, which makes it heavier but more powerful for certain use cases.
postcss is a tool for transforming CSS with JavaScript plugins. It can parse CSS into an abstract syntax tree (AST), traverse and modify nodes, and generate modified CSS. Unlike cssom, which focuses on the CSS Object Model, postcss is more about applying transformations and optimizations to CSS files and is often used in build processes.
stylecow is a CSS parser, manipulator, and polyfiller. It is similar to cssom in that it allows for parsing and manipulation of CSS, but it also includes features to help developers write modern CSS code that works in older browsers. It has a plugin system for extending its capabilities, which makes it more versatile than cssom for certain tasks.
CSSOM.js is a CSS parser written in pure JavaScript. It is also a partial implementation of CSS Object Model.
CSSOM.parse("body {color: black}")
-> {
cssRules: [
{
selectorText: "body",
style: {
0: "color",
color: "black",
length: 1
}
}
]
}
Works well in Google Chrome 6+, Safari 5+, Firefox 3.6+, Opera 10.63+. Doesn't work in IE < 9 because of unsupported getters/setters.
To use CSSOM.js in the browser you might want to build a one-file version that exposes a single CSSOM
global variable:
➤ git clone https://github.com/NV/CSSOM.git
➤ cd CSSOM
➤ node build.js
build/CSSOM.js is done
To use it with Node.js or any other CommonJS loader:
➤ npm install cssom
You parse CSS to mungle, minify or reformat code like this:
div {
background: gray;
background: linear-gradient(to bottom, white 0%, black 100%);
}
This pattern is often used to give browsers that don’t understand linear gradients a fallback solution (e.g. gray color in the example).
In CSSOM, background: gray
gets overwritten.
It does NOT get preserved.
If you do CSS mungling, minification, or image inlining, considere using one of the following:
To run tests locally:
➤ git submodule init
➤ git submodule update
FAQs
CSS Object Model implementation and CSS parser
The npm package cssom receives a total of 29,539,271 weekly downloads. As such, cssom popularity was classified as popular.
We found that cssom demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
A record 2,709 developers participated in the 2024 Ruby on Rails Community Survey, revealing key tools, practices, and trends shaping the Rails ecosystem.
Security News
In 2023, data breaches surged 78% from zero-day and supply chain attacks, but developers are still buried under alerts that are unable to prevent these threats.
Security News
Solo open source maintainers face burnout and security challenges, with 60% unpaid and 60% considering quitting.