From 26105034da4fcce7ac883c899d781f016559310d Mon Sep 17 00:00:00 2001 From: ruki Date: Thu, 8 Nov 2018 00:38:48 +0800 Subject: switch to vuepress --- node_modules/css-parse/Readme.md | 142 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 142 insertions(+) create mode 100644 node_modules/css-parse/Readme.md (limited to 'node_modules/css-parse/Readme.md') diff --git a/node_modules/css-parse/Readme.md b/node_modules/css-parse/Readme.md new file mode 100644 index 00000000..0f6169ef --- /dev/null +++ b/node_modules/css-parse/Readme.md @@ -0,0 +1,142 @@ +# css-parse [![Build Status](https://travis-ci.org/visionmedia/css-parse.png)](https://travis-ci.org/visionmedia/css-parse) + + JavaScript CSS parser for nodejs and the browser. + +## Installation + + $ npm install css-parse + +## Usage + +````javascript +var parse = require('css-parse'); + +// CSS input string +var css = "body { \n background-color: #fff;\n }"; + +var output_obj = parse(css); + +// Position and Source parameters +var output_obj_pos = parse(css, { position: true, source: 'file.css' }); + +// Print parsed object as CSS string +console.log(JSON.stringify(output_obj, null, 2)); + +```` + +## Example + +css: + +```css +body { + background: #eee; + color: #888; +} +``` + +parse tree: + +```json +{ + "type": "stylesheet", + "stylesheet": { + "rules": [ + { + "type": "rule", + "selectors": [ + "body" + ], + "declarations": [ + { + "type": "declaration", + "property": "background", + "value": "#eee" + }, + { + "type": "declaration", + "property": "color", + "value": "#888" + } + ] + } + ] + } +} +``` + +parse tree with `.position` enabled: + +```json +{ + "type": "stylesheet", + "stylesheet": { + "rules": [ + { + "type": "rule", + "selectors": [ + "body" + ], + "declarations": [ + { + "type": "declaration", + "property": "background", + "value": "#eee", + "position": { + "start": { + "line": 3, + "column": 3 + }, + "end": { + "line": 3, + "column": 19 + } + } + }, + { + "type": "declaration", + "property": "color", + "value": "#888", + "position": { + "start": { + "line": 4, + "column": 3 + }, + "end": { + "line": 4, + "column": 14 + } + } + } + ], + "position": { + "start": { + "line": 2, + "column": 1 + }, + "end": { + "line": 5, + "column": 2 + } + } + } + ] + } +} +``` + +If you also pass in `source: 'path/to/original.css'`, that will be set +on `node.position.source`. + +## Performance + + Parsed 15,000 lines of CSS (2mb) in 40ms on my macbook air. + +## Related + + [css-stringify](https://github.com/visionmedia/css-stringify "CSS-Stringify") + [css-value](https://github.com/visionmedia/css-value "CSS-Value") + +## License + + MIT -- cgit v1.2.3