Convert values with PostCSS (e.g. ms -> s)
JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
.all-contributorsrc
.babelrc
.editorconfig
.gitignore
.travis.yml
CHANGELOG.md
LICENSE-MIT
README.md
package.json

README.md

postcss-convert-values Build Status NPM version Dependency Status

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.

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.

Contributors

Thanks goes to these wonderful people (emoji key):


Ben Briggs

πŸ’» πŸ“– πŸ‘€ ⚠️

Bogdan Chadkin

πŸ’» πŸ“– πŸ‘€ ⚠️

Roman Komarov

πŸ›

Dmitry Kiselyov

πŸ›

Charlike Mike Reagent

πŸ’» ⚠️

Vyacheslav Shebanov

πŸ“–

Marek β€˜saji’ Augustynowicz

πŸ’» ⚠️

Jonny Gerig Meyer

πŸ’» ⚠️

This project follows the all-contributors specification. Contributions of any kind welcome!

License

MIT Β© Ben Briggs