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

Package detail

@csstools/postcss-logical-resize

csstools6.4mMIT-03.0.0TypeScript support: included

Use logical values in the resize property

block, css, inline, logical, postcss, postcss-plugin, resize

readme

PostCSS Logical Resize PostCSS Logo

npm install @csstools/postcss-logical-resize --save-dev

PostCSS Logical Resize lets you use logical, rather than physical, values for resize, following the CSS Logical Properties and Values specification.

.resize-block {
    resize: block;
}

.resize-inline {
    resize: inline;
}

/* becomes */

.resize-block {
    resize: vertical;
}

.resize-inline {
    resize: horizontal;
}

Usage

Add PostCSS Logical Resize to your project:

npm install postcss @csstools/postcss-logical-resize --save-dev

Use it as a PostCSS plugin:

const postcss = require('postcss');
const postcssLogicalResize = require('@csstools/postcss-logical-resize');

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

Options

blockDirection & inlineDirection

The blockDirection and inlineDirection options allow you to specify the direction of the block and inline axes. The default values are top-to-bottom and left-to-right respectively, which would match any latin language.

You should tweak these values so that they are specific to your language and writing mode.

postcssLogicalResize({
    blockDirection: 'right-to-left',
    inlineDirection: 'top-to-bottom'
})
.resize-block {
    resize: block;
}

.resize-inline {
    resize: inline;
}

/* becomes */

.resize-block {
    resize: horizontal;
}

.resize-inline {
    resize: vertical;
}

Each direction must be one of the following:

  • top-to-bottom
  • bottom-to-top
  • left-to-right
  • right-to-left

You can't mix two vertical directions or two horizontal directions so for example top-to-bottom and right-to-left are valid, but top-to-bottom and bottom-to-top are not.

changelog

Changes to PostCSS Logical Resize

3.0.0

August 3, 2024

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

Full CHANGELOG