Security News
The Dark Side of Open Source
At Node Congress, Socket CEO Feross Aboukhadijeh uncovers the darker aspects of open source, where applications that rely heavily on third-party dependencies can be exploited in supply chain attacks.
@csstools/postcss-progressive-custom-properties
Advanced tools
Readme
PostCSS Progressive Custom Properties is a utility plugin to correctly declare Custom Property fallbacks and enhancements.
[!WARNING] It is not intended to be used directly by stylesheet authors. Meant to be included in other PostCSS plugins that provide CSS value transforms as fallbacks.
Custom Properties are not discarded like regular declarations when invalid. This makes it tricky to provide fallback values for older browsers.
The solution is to wrap Custom Property declarations in an @supports
rule.
:root {
/* fallback */
--a-color: red;
/* progressive enhancement */
--a-color: oklch(40% 0.234 0.39 / var(--opacity-50));
}
/* becomes */
:root {
--a-color: red;
}
@supports (color: oklch(0% 0 0)) {
:root {
--a-color: oklch(40% 0.234 0.39 / var(--opacity-50));
}
}
initial
and <white space>
are ignored.
.initial {
--prop-1: red;
--prop-1: initial;
}
.white-space {
--prop-1: red;
--prop-1:;
--prop-2: red;
--prop-2: ;
--prop-3: red;
--prop-3: ;
}
/* remains */
.initial {
--prop-1: red;
--prop-1: initial;
}
.white-space {
--prop-1: red;
--prop-1:;
--prop-2: red;
--prop-2: ;
--prop-3: red;
--prop-3: ;
}
Add PostCSS Progressive Custom Properties to your project:
npm install @csstools/postcss-progressive-custom-properties --save-dev
Use PostCSS Progressive Custom Properties as a PostCSS plugin:
const postcss = require('postcss');
const postcssCustomProperties = require('@csstools/postcss-progressive-custom-properties');
postcss([
postcssProgressiveCustomProperties()
]).process(YOUR_CSS /*, processOptions */);
This plugin wraps Custom Property override declarations in an @supports
rule.
With PostCSS 8 this trigger declaration visitors to run again.
Make sure your plugin detects and ignores values inside relevant @supports
rules.
PostCSS Progressive Custom Properties runs in all Node environments, with special instructions for:
Node | PostCSS CLI | Webpack | Gulp | Grunt |
---|
FAQs
Correctly declare progressive enhancements for CSS Custom Properties.
The npm package @csstools/postcss-progressive-custom-properties receives a total of 3,998,261 weekly downloads. As such, @csstools/postcss-progressive-custom-properties popularity was classified as popular.
We found that @csstools/postcss-progressive-custom-properties demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 3 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
At Node Congress, Socket CEO Feross Aboukhadijeh uncovers the darker aspects of open source, where applications that rely heavily on third-party dependencies can be exploited in supply chain attacks.
Research
Security News
The Socket Research team found this npm package includes code for collecting sensitive developer information, including your operating system username, Git username, and Git email.
Security News
OpenJS is warning of social engineering takeovers targeting open source projects after receiving a credible attempt on the foundation.