1.9 KiB
postcss-convert-values
Convert values with PostCSS (e.g. ms -> s)
Install
With npm 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.
Input
h1 {
font-size: 16px;
width: 0em
}
Output
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 for examples for your environment.
Contributors
See CONTRIBUTORS.md.
License
MIT © Ben Briggs