Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@csstools/postcss-unset-value

csstools13.2mMIT-04.0.0TypeScript support: included

Use the unset keyword in CSS.

inherit, initial, postcss-plugin, unset

readme

PostCSS Unset Value PostCSS Logo

npm version Build Status Discord

Baseline Status CSS Standard Status

PostCSS Unset Value lets you use the unset keyword, following the CSS Cascading and Inheritance specification.

.color {
    color: unset;
}

.border-color {
    border-color: unset;
}

.margin {
    margin: unset;
}


/* becomes */
.color {
    color: inherit;
}

.border-color {
    border-color: initial;
}

.margin {
    margin: initial;
}

Usage

Add PostCSS Unset Value to your project:

npm install postcss @csstools/postcss-unset-value --save-dev

Use it as a PostCSS plugin:

const postcss = require('postcss');
const postcssUnsetValue = require('@csstools/postcss-unset-value');

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

PostCSS Unset Value runs in all Node environments, with special instructions for:

Node PostCSS CLI Webpack Gulp Grunt

Options

preserve

The preserve option determines whether the original source is preserved. By default, it is not preserved.

postcssUnsetValue({ preserve: true })
.color {
    color: unset;
}

.border-color {
    border-color: unset;
}

.margin {
    margin: unset;
}

/* becomes */

.color {
    color: inherit;
    color: unset;
}

.border-color {
    border-color: initial;
    border-color: unset;
}

.margin {
    margin: initial;
    margin: unset;
}

changelog

Changes to PostCSS Unset Value

4.0.0

August 3, 2024

  • Updated: Support for Node v18+ (major).

Full CHANGELOG