JSPM

  • Created
  • Published
  • Downloads 4708118
  • Score
    100M100P100Q245077F
  • License MIT-0

Use hwb() color functions in CSS

Package Exports

  • @csstools/postcss-hwb-function

Readme

PostCSS HWB Function PostCSS Logo

npm version Build Status Discord

Baseline Status CSS Standard Status

PostCSS HWB Function lets you use hwb color functions in CSS, following the CSS Color specification.

a {
    color: hwb(194 0% 0%);
    color: hwb(194 0% 0% / .5);
}

/* becomes */

a {
    color: rgb(0, 195, 255);
    color: rgba(0, 195, 255, .5);
}

Usage

Add PostCSS HWB Function to your project:

npm install postcss @csstools/postcss-hwb-function --save-dev

Use it as a PostCSS plugin:

const postcss = require('postcss');
const postcssHWBFunction = require('@csstools/postcss-hwb-function');

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

PostCSS HWB Function runs in all Node environments, with special instructions for:

Node PostCSS CLI Webpack Gulp Grunt

Options

preserve

The preserve option determines whether the original functional color notation is preserved. By default, it is not preserved.

postcssHWBFunction({ preserve: true })
a {
    color: hwb(194 0% 0%);
    color: hwb(194 0% 0% / .5);
}

/* becomes */

a {
    color: rgb(0, 195, 255);
    color: hwb(194 0% 0%);
    color: rgba(0, 195, 255, .5);
    color: hwb(194 0% 0% / .5);
}