Name Last Update
..
dist Loading commit data...
CHANGELOG.md Loading commit data...
LICENSE.md Loading commit data...
README.md Loading commit data...
package.json Loading commit data...

PostCSS Text Decoration Shorthand PostCSS Logo

npm version CSS Standard Status Build Status Discord

PostCSS Text Decoration Shorthand lets you use text-decoration as a shorthand following the Text Decoration Specification.

.example {
    text-decoration: wavy underline purple 25%;
}

/* becomes */

.example {
    text-decoration: underline;
    text-decoration: underline wavy purple;
    text-decoration-thickness: calc(0.01em * 25);
}

Usage

Add PostCSS Text Decoration Shorthand to your project:

npm install postcss @csstools/postcss-text-decoration-shorthand --save-dev

Use it as a PostCSS plugin:

const postcss = require('postcss');
const postcssTextDecorationShorthand = require('@csstools/postcss-text-decoration-shorthand');

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

PostCSS Text Decoration 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 notation is preserved. By default, it is not preserved.

postcssTextDecorationShorthand({ preserve: true })
.example {
    text-decoration: wavy underline purple 25%;
}

/* becomes */

.example {
    text-decoration: underline;
    text-decoration: underline wavy purple;
    text-decoration-thickness: calc(0.01em * 25);
    text-decoration: wavy underline purple 25%;
}