xiebaomin 213d86429b updated 1 year ago
..
CHANGELOG.md 213d86429b updated 1 year ago
LICENSE.md 213d86429b updated 1 year ago
README.md 213d86429b updated 1 year ago
index.cjs.js 213d86429b updated 1 year ago
index.cjs.js.map 213d86429b updated 1 year ago
index.es.mjs 213d86429b updated 1 year ago
index.es.mjs.map 213d86429b updated 1 year ago
package.json 213d86429b updated 1 year ago

README.md

PostCSS Overflow Shorthand PostCSS Logo

NPM Version CSS Standard Status Build Status Support Chat

PostCSS Overflow Shorthand lets you use the overflow shorthand in CSS, following the CSS Overflow specification.

html {
  overflow: hidden auto;
}

/* becomes */

html {
  overflow-x: hidden;
  overflow-y: auto;
  overflow: hidden auto;
}

Usage

Add PostCSS Overflow Shorthand to your project:

npm install postcss-overflow-shorthand --save-dev

Use PostCSS Overflow Shorthand to process your CSS:

const postcssOverflowShorthand = require('postcss-overflow-shorthand');

postcssOverflowShorthand.process(YOUR_CSS /*, processOptions, pluginOptions */);

Or use it as a PostCSS plugin:

const postcss = require('postcss');
const postcssOverflowShorthand = require('postcss-overflow-shorthand');

postcss([
  postcssOverflowShorthand(/* pluginOptions */)
]).process(YOUR_CSS /*, processOptions */);

PostCSS Overflow Shorthand runs in all Node environments, with special instructions for:

Node PostCSS CLI Webpack Create React App Gulp Grunt

Options

preserve

The preserve option determines whether the original overflow declaration is preserved. By default, it is preserved.

postcssOverflowShorthand({ preserve: false })
html {
  overflow: hidden auto;
}

/* becomes */

html {
  overflow-x: hidden;
  overflow-y: auto;
}