You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
# [postcss][postcss]-convert-values
> Convert values with PostCSS (e.g. ms -> s)
## Install
With [npm](https://npmjs.org/package/postcss-convert-values) do:
``` npm install postcss-convert-values --save ```
## Example
This plugin reduces CSS size by converting values to use different units where possible; for example, `500ms` can be represented as `.5s`. You can read more about these units in [this article][csstricks].
### Input
```css h1 { font-size: 16px; width: 0em } ```
### Output
```css h1 { font-size: 1pc; width: 0 } ```
Note that this plugin only covers conversions for duration and absolute length values. For color conversions, use [postcss-colormin][colormin].
## API
### convertValues([options])
#### options
##### length
Type: `boolean` Default: `true`
Pass `false` to disable conversion from `px` to other absolute length units, such as `pc` & `pt` & vice versa.
##### time
Type: `boolean` Default: `true`
Pass `false` to disable conversion from `ms` to `s` & vice versa.
##### angle
Type: `boolean` Default: `true`
Pass `false` to disable conversion from `deg` to `turn` & vice versa.
##### precision
Type: `boolean|number` Default: `false`
Specify any numeric value here to round `px` values to that many decimal places; for example, using `{precision: 2}` will round `6.66667px` to `6.67px`, and `{precision: 0}` will round it to `7px`. Passing `false` (the default) will leave these values as is.
It is recommended for most use cases to set this option to `2`.
## Usage
See the [PostCSS documentation](https://github.com/postcss/postcss#usage) for examples for your environment.
## Contributors
See [CONTRIBUTORS.md](https://github.com/cssnano/cssnano/blob/master/CONTRIBUTORS.md).
## License
MIT © [Ben Briggs](http://beneb.info)
[postcss]: https://github.com/postcss/postcss [csstricks]: https://css-tricks.com/the-lengths-of-css/
|