@devteaa/postcss-combine-duplicated-selectors
v10.0.5
Published
automatically keep css selectors unique
Downloads
2
Readme
Postcss combine duplicated selectors
This fork added 2 features:
- combines class with different data-v but similar props
- remove dark prefix if there is class without dark prefix with same props
Automatically detects and combines duplicated css selectors so you don't have to :smile:
Usage
Requirements
In order to use this you will need to have postcss installed. Depending on whether or not you want to use the CLI you need to install postcss-cli.
npm install --save-dev postcss postcss-combine-duplicated-selectors
# or
yarn add --dev postcss postcss-combine-duplicated-selectors
Using PostCSS JS API
'use strict';
const fs = require('fs');
const postcss = require('postcss');
const css = fs.readFileSync('src/app.css');
postcss([require('postcss-combine-duplicated-selectors')])
.process(css, {from: 'src/app.css', to: 'app.css'})
.then((result) => {
fs.writeFileSync('app.css', result.css);
if (result.map) fs.writeFileSync('app.css.map', result.map);
});
Using PostCSS CLI
postcss style.css --use postcss-combine-duplicated-selectors --output newcss.css
Using Vite
In a postcss.config.js
file :
module.exports = {
plugins: [require('postcss-combine-duplicated-selectors')],
};
Example
Input
.module {
color: green;
}
.another-module {
color: blue;
}
.module {
background: red;
}
.another-module {
background: yellow;
}
Output
.module {
color: green;
background: red;
}
.another-module {
color: blue;
background: yellow;
}
Duplicated Properties
Duplicated properties can optionally be combined.
Set the removeDuplicatedProperties
option to true
to enable.
const postcss = require('postcss');
const combineSelectors = require('postcss-combine-duplicated-selectors');
postcss([combineSelectors({removeDuplicatedProperties: true})]);
When enabled the following css
.a {
height: 10px;
background: orange;
background: rgba(255, 165, 0, 0.5);
}
will combine into
.a {
height: 10px;
background: rgba(255, 165, 0, 0.5);
}
In order to limit this to only combining properties when the values are equal, set the removeDuplicatedValues
option to true
instead. This could clean up duplicated properties, but allow for conscious duplicates such as fallbacks for custom properties.
const postcss = require('postcss');
const combineSelectors = require('postcss-combine-duplicated-selectors');
postcss([combineSelectors({removeDuplicatedValues: true})]);
This will transform the following css
.a {
height: 10px;
}
.a {
width: 20px;
background: var(--custom-color);
background: rgba(255, 165, 0, 0.5);
}
into
.a {
height: 10px;
width: 20px;
background: var(--custom-color);
background: rgba(255, 165, 0, 0.5);
}
Media Queries
If you have code with media queries, pass code through postcss-combine-media-query or css-mquery-packer before postcss-combine-duplicated-selectors to ensure optimal results.