98 lines
1.9 KiB
Markdown
98 lines
1.9 KiB
Markdown
# [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/
|