csstransform
Automated css transformations.
Installation
npm install csstransform --save-dev
Example Usage
csstransform can be used to transform existing css and transform for example it's selectors.
var css = __dirname + '/input/bootstrap.css';var target = __dirname + '/output/bootstrap-match-string.css'; var csstransform = ;var csst = ;csst;csst;
How it works
csstransform uses cssom (a full fledged css parser) to parse the css into an internal css dom. When calling toString(target)
, the css is formatted with cssbeautify.
API
csstransform(css)
Creates a new CSST Object and parses the css file into a cssom Object.
Parameters css: String, css Path to the css file to read
Returns Object, the new created CCST Object that holds the parsed css dom for further transformations.
transformSelectorText(op)
Transforms the css selectors. transformSelectorText is chainable. Therefore several Transformation can take place.
Parameters op: Object, {[match,] [exclude,] [append,] [prepend,] [replace]}
Returns Object, this CSST object for function chanining.
op Object
{
prepend: String,
append: String,
replace: [String, String],
match: String or Regex,
exclude: String or Regex
}
op Object Description
prepend
prepend will prepend the given string to the selector.
append
append will append the given string to the selector.
replace
replace is an Array where the first element is the String that should be replaced and the second element is the String that will be used as replacement.
match
If match is missing, it matches every selector. If match is provided with a String value, it will be used as contains(). If match is a Regex, it will directly be used in the .match(regex) function.
exclude
Opposite of match. The found selectors will be excluded from the transfomration.
toString(target)
writes the the formatted css to the target file.
Parameters target: String, Path to the target file.
Returns String, The formatted css.
Tests
Run tests with mocha:
mocha