Awesome
PostCSS Short Overflow <img src="https://postcss.github.io/postcss/logo.svg" alt="PostCSS" width="90" height="90" align="right">
PostCSS Short Overflow lets you write overflow-x
and overflow-y
with the
overflow
shorthand in CSS.
html {
overflow: hidden auto;
}
[contenteditable] {
overflow: * auto;
}
/* becomes */
html {
overflow-x: hidden;
overflow-y: auto;
}
[contenteditable] {
overflow-y: auto;
}
Usage
Add PostCSS Short Overflow to your project:
npm install postcss-short-overflow --save-dev
Use PostCSS Short Overflow to process your CSS:
const postcssShortOverflow = require('postcss-short-overflow');
postcssShortOverflow.process(YOUR_CSS /*, processOptions, pluginOptions */);
Or use it as a PostCSS plugin:
const postcss = require('postcss');
const postcssShortOverflow = require('postcss-short-overflow');
postcss([
postcssShortOverflow(/* pluginOptions */)
]).process(YOUR_CSS /*, processOptions */);
PostCSS Short Overflow runs in all Node environments, with special instructions for:
Node | PostCSS CLI | Webpack | Create React App | Gulp | Grunt |
---|
Options
prefix
The prefix
option defines a prefix required by properties being transformed.
Wrapping dashes are automatically applied, so that x
would transform
-x-overflow
.
postcssShortOverflow({ prefix: 'x' });
html {
-x-overflow: hidden auto;
}
/* becomes */
html {
overflow-x: hidden;
overflow-y: auto;
}
skip
The skip
option defines the skip token used to ignore portions of the
shorthand.
postcssShortOverflow({ skip: '-' });
[contenteditable] {
overflow: - auto;
}
/* becomes */
[contenteditable] {
overflow-y: auto;
}