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