.. | ||
dist | ||
node_modules | ||
CHANGELOG.md | ||
LICENSE-MIT | ||
package.json | ||
README.md |
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