|
|
- # [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/
|