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

Package detail

@csstools/postcss-normalize-display-values

csstools17.4mMIT-04.0.0TypeScript support: included

Use two values display syntax for inner and outer display types.

block, css, display, flex, flow, flow-root, grid, inline, inline-block, inline-flex, inline-grid, inline-table, list-item, postcss-plugin, ruby, ruby-base, ruby-text, run-in, table, table-caption, table-cell

readme

PostCSS Normalize Display Values PostCSS Logo

npm version Build Status Discord

Baseline Status CSS Standard Status

PostCSS Normalize Display Values lets you specify definition of outer and inner displays types for an element.

.element {
  display: inline flow-root;
}

/* becomes */

.element {
  display: inline-block;
  display: inline flow-root;
}

See prior work by cssnano here postcss-normalize-display-values To ensure long term maintenance and to provide the needed features this plugin was recreated based on cssnano's work.

Usage

Add PostCSS Normalize Display Values to your project:

npm install postcss @csstools/postcss-normalize-display-values --save-dev

Use it as a PostCSS plugin:

const postcss = require('postcss');
const postcssNormalizeDisplayValues = require('@csstools/postcss-normalize-display-values');

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

PostCSS Normalize Display Values 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 preserved.

postcssNormalizeDisplayValues({ preserve: false })
.element {
  display: inline flow-root;
}

/* becomes */

.element {
  display: inline-block; 
}

changelog

Changes to PostCSS Normalize Display Values

4.0.0

August 3, 2024

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

Full CHANGELOG