PostCSS Short Border

PostCSS Short Border lets you omit sides within border- properties in CSS. It also lets you fully define individual values on the border property using dividers (/).

1.example-1 {
2  border-color: blue blue *;
3}
4
5.example-2 {
6  border-width: 1px *;
7}
8
9.example-3 {
10  border: 1px 2px / solid / red orange;
11}
12
13/* becomes */
14
15.example-1 {
16  border-top-color: blue;
17  border-right-color: blue;
18  border-left-color: blue;
19}
20
21.example-2 {
22  border-top-width: 1px;
23  border-bottom-width: 1px;
24}
25
26.example-3 {
27  border-width: 1px 2px;
28  border-style: solid;
29  border-color: red orange;
30}

Usage

Add PostCSS Short Border to your project:

1npm install postcss-short-border --save-dev

Use PostCSS Short Border to process your CSS:

1const postcssShortBorder = require('postcss-short-border');
2
3postcssShortBorder.process(YOUR_CSS /*, processOptions, pluginOptions */);

Or use it as a PostCSS plugin:

1const postcss = require('postcss');
2const postcssShortBorder = require('postcss-short-border');
3
4postcss([
5  postcssShortBorder(/* pluginOptions */)
6]).process(YOUR_CSS /*, processOptions */);

PostCSS Short Border 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-border.

1postcssShortBorder({ prefix: 'x' });

1.example-1 {
2  -x-border-color: blue blue *;
3}
4
5/* becomes */
6
7.example-1 {
8  border-top-color: blue;
9  border-right-color: blue;
10  border-left-color: blue;
11}

skip

The skip option defines the skip token used to ignore portions of the shorthand.

1postcssShortBorder({ skip: '-' });

1.example-1 {
2  border-color: blue blue -;
3}
4
5/* becomes */
6
7.example-1 {
8  border-top-color: blue;
9  border-right-color: blue;
10  border-left-color: blue;
11}