| # [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/main/CONTRIBUTORS.md). | |
| ## License | |
| MIT © [Ben Briggs](https://beneb.info) | |
| [postcss]: https://github.com/postcss/postcss | |
| [csstricks]: https://css-tricks.com/the-lengths-of-css/ |