postcss-gap-properties

Use the gap, column-gap, and row-gap shorthand properties in CSS

Usage no npm install needed!

<script type="module">
  import postcssGapProperties from 'https://cdn.skypack.dev/postcss-gap-properties';
</script>

README

PostCSS Gap Properties PostCSS Logo

NPM Version CSS Standard Status Build Status Support Chat

PostCSS Gap Properties lets you use the gap, column-gap, and row-gap shorthand properties in CSS, following the CSS Grid Layout specification.

.standard-grid {
    gap: 20px;
}

.spaced-grid {
    column-gap: 40px;
    row-gap: 20px;
}

/* becomes */

.standard-grid {
    grid-gap: 20px;
    gap: 20px;
}

.spaced-grid {
    grid-column-gap: 40px;
    column-gap: 40px;
    grid-row-gap: 20px;
    row-gap: 20px;
}

Usage

Add PostCSS Gap Properties to your project:

npm install postcss postcss-gap-properties --save-dev

Use PostCSS Gap Properties to process your CSS:

import postcssGapProperties from 'postcss-gap-properties';

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

Or use it as a PostCSS plugin:

import postcss from 'postcss';
import postcssGapProperties from 'postcss-gap-properties';

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

PostCSS Gap Properties runs in all Node environments, with special instructions for:

Node Webpack Create React App Gulp Grunt

Options

preserve

The preserve option determines whether the original gap declaration should remain in the CSS. By default, the original declaration is preserved.