# postcss-value-parser

**Repository Path**: mirrors_davidtheclark/postcss-value-parser

## Basic Information

- **Project Name**: postcss-value-parser
- **Description**: Transforms css values into the tree
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-08
- **Last Updated**: 2026-04-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[![Travis CI](https://travis-ci.org/TrySound/postcss-value-parser.svg)](https://travis-ci.org/TrySound/postcss-value-parser)

# postcss-value-parser

Transforms css values and at-rule params into the tree.

## Usage

```js
var parser = require('postcss-value-parser');

/*{
    nodes: [
      type: 'function',
      value: 'rgba',
      before: '',
      after: '',
      nodes: [
        { type: 'word', value: '233' },
        { type: 'div', value: ',', before: '', after: ' ' },
        { type: 'word', value: '45' },
        { type: 'div', value: ',', before: '', after: ' ' },
        { type: 'word', value: '66' },
        { type: 'div', value: ',', before: ' ', after: '' },
        { type: 'word', value: '.5' }
      ]
    ]
  }*/
parser('rgba(233, 45, 66 ,.5)').walk(function (node) {
  if (node.type === 'function' && node.value === 'rgba') {
    var color = node.nodes.filter(function (node) {
      return node.type === 'word';
    }).map(function (node) {
      return Number(node.value);
    }); // [233, 45, 66, .5]

    node.type = 'word';
    node.value = convertToHex(color);
  }
}).toString(); // #E92D42
```

### Prevent walking into function

```js
parser('url(some url) 50% 50%')
  .walk(function (node) {
    // Your code

    if (node.type === 'function' && node.value === 'url') {
      return false;
    }
  })
  .toString();
```

### Url node

```
url( /path/to/image )
```

will be parsed to

```js
[{
  type: 'function',
  value: 'url',
  before: ' ',
  after: ' ',
  nodes: [
    { type: 'word', value: '/path/to/image' }
  ]
}]
```

## Node types

- `{ type: 'word', value: 'any' }`
- `{ type: 'string', value: 'string', quote: '"' }`
- `{ type: 'string', value: 'string', quote: '\'' }`
- `{ type: 'div', value: '/' , before: ' ', after: ' ' }`
- `{ type: 'div', value: ',', before: ' ', after: ' ' }`
- `{ type: 'div', value: ':', before: ' ', after: ' ' }`
- `{ type: 'space', value: ' ' }` space as a separator
- `{ type: 'function', value: 'name', before: '', after: '', nodes: [] }`

## API

```
var valueParser = require('postcss-value-parser');
```

### valueParser.unit(value)

Returns parsed value.

```js
// .2rem
{
  number: '.2',
  unit: 'rem'
}
```

### valueParser.stringify(nodes)

Stringifies node and array of nodes.

### valueParser.walk(nodes, cb[, bubble])

Walks each provided node, recursively for each node in a function.

Returning `false` in the callback will prevent traversal of deeper, nested nodes(inside a function). You can use this to walk over only the immediate children. *note: This only applies if `bubble` is `false`(default).*

Returns `this` instance.

- `nodes`: array - `value-parser` nodes
- `cb(node, index, nodes)`: function - Function to execute for each node
- `bubble`: boolean - Walk from the deepest nodes upwards

### var p = valueParser(value)

Returns parsed tree.

### p.nodes

Root nodes list.

### p.toString()

Stringify tree to the value.

### p.walk(cb[, bubble])

Walks each node since `p.nodes`.

# License

MIT © [Bogdan Chadkin](mailto:trysound@yandex.ru)