JSPM

  • Created
  • Published
  • Downloads 4912857
  • Score
    100M100P100Q219868F
  • License MPL-2.0

A CSS property value parser for use with PostCSS

Package Exports

  • postcss-values-parser
  • postcss-values-parser/lib/nodes/Func
  • postcss-values-parser/lib/nodes/Punctuation

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (postcss-values-parser) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

[tests]: https://img.shields.io/circleci/project/github/shellscape/postcss-values-parser.svg [tests-url]: https://circleci.com/gh/shellscape/postcss-values-parser



postcss-values-parser [![tests][tests]][tests-url] cover size

A CSS property value parser built upon PostCSS, following the same node and traversal patterns as PostCSS.

Install

Using npm:

npm install postcss-values-parser --save-dev

Please consider becoming a patron if you find this module useful.

Requirements

postcss-values-parser Node version v6.14.0+ and PostCSS v7.0.0+.

Benefits

  • Leverages PostCSS and its tokenizer under the hood
  • Doesn't strip characters; eg. parenthesis
  • Full AST traversal
  • Ability to walk the AST for every Node type
  • Convenience methods to stringify Nodes
  • Follows PostCSS patterns for whitespace between Nodes
  • Provides convenience properties for number units, colors, etc.

Usage

Using the parser is straightforward and minimalistic:

const { parse } = require('postcss-values-parser');

const root = parse('#fff');
const node = root.first;

// → Word {
//     raws: { before: '', after: '' },
//     value: '#fff',
//     type: 'word',
//     isHex: true,
//     isColor: true,
//     isVariable: false,
//     ...
//   }

Please see the Documentation for further information on using the module.

Meta

CONTRIBUTING

LICENSE (Mozilla Public License)