Skip to content
Use the gap, column-gap, and row-gap shorthand properties in CSS
Branch: master
Clone or download
Latest commit 170ce78 Sep 18, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
test 1.0.0 May 1, 2018
.editorconfig 1.0.0 May 1, 2018
.gitignore
.rollup.js 2.0.0 Sep 18, 2018
.tape.js
.travis.yml 2.0.0 Sep 18, 2018
CHANGELOG.md
CONTRIBUTING.md 1.0.0 May 1, 2018
INSTALL.md
LICENSE.md 1.0.0 May 1, 2018
README.md 2.0.0 Sep 18, 2018
index.js 1.0.0 May 1, 2018
package.json

README.md

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-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.

You can’t perform that action at this time.