postcss-pixrem
v6.0.3
Published
A CSS post-processor that generates pixel fallbacks for rem units.
Downloads
145
Maintainers
Readme
Pixrem
PostCSS plugin that generates pixel fallbacks for rem units.
Notes
This is a fork of the original https://github.com/robwierzbowski/node-pixrem by robwierzbowski robwierzbowski. With additional work done by onigoetz and philiprenich.
npm install --save postcss pixrem
Installation
npm install --save postcss pixrem
Usage
Pixrem is a CSS post-processor that, given CSS and a root em value, returns CSS with pixel unit fallbacks or replacements. It's based on browser data so only needed fallbacks will be added. Basically, it's for IE8 or less, and for IE9 & IE10 in the font
shorthand property and in pseudo-elements.
Example
'use strict';
var fs = require('fs');
var pixrem = require('pixrem');
var postcss = require('postcss');
var css = fs.readFileSync('main.css', 'utf8');
var processedCss = postcss([pixrem]).process(css).css;
fs.writeFile('main.with-fallbacks.css', processedCss, function (err) {
if (err) {
throw err;
}
console.log('IE8, you\'re welcome.');
});
Pixrem takes this:
.sky {
margin: 2.5rem 2px 3em 100%;
color: blue;
}
@media screen and (min-width: 20rem) {
.leaf {
margin-bottom: 1.333rem;
font-size: 1.5rem;
}
}
And returns this:
.sky {
margin: 40px 2px 3em 100%;
margin: 2.5rem 2px 3em 100%;
color: blue;
}
@media screen and (min-width: 20rem) {
.leaf {
margin-bottom: 1.333rem;
font-size: 1.5rem;
}
}
Options
Type: Object | Null
Default: {rootValue: 16, replace: false, atrules: false, html: true, browsers: 'ie <= 8', unitPrecision: 3}
rootValue
the root element font size. Can bepx
,rem
,em
,%
, or unitless pixel value. Pixrem also tries to get the root font-size from CSS (html
or:root
) and overrides this option. Usehtml
option to disable this behaviour.replace
replaces rules containingrem
s instead of adding fallbacks.atrules
generates fallback in at-rules too (media-queries)html
overrides root font-size from CSShtml {}
or:root {}
browsers
sets browser's range you want to target, based on browserslistunitPrecision
control the significant digits after the decimal point
Contribute
Report bugs and feature proposals in the Github issue tracker. Run tests with npm test
. In lieu of a formal styleguide, take care to maintain the existing coding style.