postcss-logical-fallback
v1.0.1
Published
PostCSS plugin for logical fallback props
Downloads
1
Maintainers
Readme
postcss-logical-fallback
This is postcss plugin for logical css props support in legacy browsers. Main idea of the plugin is an opportunity to write logical styles like in modern browsers in legacy browsers. When all of your supported browsers will support all modern logical spec you can just delete this plugin and don't rewrite your styles. Second idea of the plugin is to use logical props where they supported and do fallback only in non-supported browsers.
Main purpose of this plugin is creating fallbacks for bad supported logical props in legacy browsers. We have distinguished:
Absolute positioning props like
inset-inline-start
,inset-inline-end
,inset-block-start
andinset-block-end
due to bad support in safari (14.1+ on desktop, 14.5+ on mobile), chrome (87+) and firefox (66+) and due to high prevalence of these props.Shorthand props like
inset-inline
,inset-block
,margin-inline
,margin-block
,padding-inline
,padding-block
due to same bad support in browsers
Full logical props support you can see here
We recommend to use this plugin with autoprefixer and setup our plugin before autoprefixer
Important Note
This plugin has been primarily designed and optimized to handle websites that support left-to-right (LTR)and right-to-left (RTL) languages. This includes languages like English, French, German (LTR), and languages like Arabic, Hebrew, Persian (RTL). Please note that the utility and functionality of this plugin may be limited when applied to websites that do not fall within these language categories.
WARNING Plugin is based on @supports at rule, so it has to be supported, see on can i use
Usage
Step 1: install plugin and postcss
npm install --save-dev postcss postcss-logical-fallback
Step 2: Find config at the root of your project: postcss.config.js
,
"postcss"
section in package.json
or postcss
section in your build config.
If you haven't already use postcss you should setup it according to official documentation and add postcss-logical-fallback after it.
Step 3: Add plugin to the plugin list
module.exports = {
plugins: [
+ require('postcss-logical-fallback'),
require('autoprefixer')
]
}
Examples
Fallback for absolute positioning props
Before
.class {
inset-block-start: 12px;
inset-inline-end: 12px;
}
After
@supports (inset-block-start: 12px) {
.class {
inset-block-start: 12px;
inset-inline-end: 12px;
}
}
@supports not (inset-block-start: 12px) {
.class {
top: 12px;
right: 12px;
}
[dir="rtl"] .class {
right: 0;
left: 12px;
}
}
Fallback for shorthands
Before
.class {
margin-inline: 12px;
padding-block: 24px 36px;
}
After
.class {
margin-inline-start: 12px;
margin-inline-end: 12px;
padding-block-start: 24px;
padding-block-end: 36px;
}
Fallback for inset shorthands
Before
.class {
inset-inline: 12px;
}
.multiple-props {
inset-inline: 24px 36px;
}
After
@supports (inset-inline: 12px) {
.class {
inset-inline: 12px;
}
.multiple-props {
inset-inline: 24px 36px;
}
}
@supports not (inset-inline: 12px) {
.class {
left: 12px;
right: 12px;
}
.multiple-props {
left: 24px;
right: 36px;
}
[dir="rtl"] .multiple-props {
left: 36px;
right: 24px;
}
}