40 lines
1.5 KiB
Plaintext
40 lines
1.5 KiB
Plaintext
|
# Emmet stylesheet abbreviation parser
|
|||
|
|
|
|||
|
|
Parses given Emmet *stylesheet* abbreviation into AST. Parsing is performed in two steps: first it tokenizes given abbreviation (useful for syntax highlighting in editors) and then tokens are analyzed and converted into AST nodes as plain, JSON-serializable objects.
|
|||
|
|
|
|||
|
|
Unlike in [markup abbreviations](/packages/abbreviation), elements in stylesheet abbreviations cannot be nested and contain attributes, but allow embedded values in element names.
|
|||
|
|
|
|||
|
|
## Usage
|
|||
|
|
|
|||
|
|
You can install it via npm:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm install @emmetio/css-abbreviation
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Then add it into your project:
|
|||
|
|
|
|||
|
|
```js
|
|||
|
|
import parse from '@emmetio/css-abbreviation';
|
|||
|
|
|
|||
|
|
const props = parse('p10+poa');
|
|||
|
|
/* [{
|
|||
|
|
name: 'p',
|
|||
|
|
value: [{ type: 'CSSValue', value: [...] }],
|
|||
|
|
important: false
|
|||
|
|
}, {
|
|||
|
|
name: 'poa',
|
|||
|
|
value: [],
|
|||
|
|
important: false
|
|||
|
|
}] */
|
|||
|
|
```
|
|||
|
|
The returned result is an array of `CSSProperty` items: a node with name and values.
|
|||
|
|
|
|||
|
|
## Abbreviation syntax
|
|||
|
|
|
|||
|
|
Emmet stylesheet abbreviation element may start with name and followed by values, optionally chained with `-` delimiter. In most cases, actual CSS properties doesn’t have numbers in their names (or at least they are not used in abbreviation shortcuts) so a number right after alpha characters is considered as *embedded value*, as well as colors starting with `#` character: `p10`, `bg#fc0` etc. If implicit name/value boundary can’t be identified, you should use `-` as value separator: `m-a`, `p10-20` etc.
|
|||
|
|
|
|||
|
|
### Operators
|
|||
|
|
|
|||
|
|
Since CSS properties can’t be nested, the only available operator is `+`.
|