minify-selectors
Post-processor that minifies classes and IDs selector names in CSS, HTML and Javascript files. Each unique identifier, and any subsequent occurances, is converted to an ultracompact CSS valid selector name.
Wrings out that little bit more out of your payload sizes and shave off a wee bit off file parse times. Additionally adds a certain degree of obfuscation to your selector names and stylesheets.
Please note:
minify-selectors only supports regular CSS, HTML and JS files. minify-selectors should be one of the final steps in your build process — SASS/SCSS, LESS, Typescript, JQuery, Handlebars, etc. should be compiled or transpiled first into its respective vanilla form.
Examples
CSS
[id='page--default'] { … }
.sidebar, .site-nav { … }
.sidebar .search:focus-within { … }
.sidebar--expanded a.is-active { … }
[id='a'], { … }
.b, .c { … }
.b .d:focus-within { … }
.e a.d { … }
HTML
<body id="page--default">
<nav class="site-nav">
<div class="search has-content">
<label for="site-search" class="text--muted text--center">…</label>
<input type="text" id="site-search" class="form-input--single form-input--lg border--thick">
</div>
</nav>
</body>
<body id="a">
<nav class="c">
<div class="d a1">
<label for="y" class="F j">…</label>
<input type="text" id="y" class="A9 t Av">
</div>
</nav>
</body>
JS
for (let link of document.querySelectorAll('a.anchor')) {
link.classList.remove('is-active');
}
for (let link of document.querySelectorAll('a.Bd')) {
link.classList.remove('d');
}
For a full outline of capabilities and current limitations, see parse_selectors/info.md.
Usage
CLI
-
Install from npm:
npm i -g minify-selectors
-
Run in command line:
minify-selectors --input "example/dir/src" --output "example/dir/dist"
npm scripts
-
Install from npm:
npm i minify-selectors
-
Include minify-selectors in your package.json scripts:
"scripts": {
"build": "npm run build:webpack && npm run build:minify-selectors",
"build:minify-selectors": "minify-selectors --input \"example/dir/src/\" --output \"example/dir/dist/\"",
"build:webpack": "webpack --config config/webpack-prod.config.js"
},
-
Run npm script:
npm run build
Options
Flag | Description |
---|
--input (or -i ) | Directory or file to process. If a directory path is provided — any CSS, HTML and JS files in the given directory and sub-directories will be parsed. If only a filepath is provided — only the given file will be parsed. |
--output (or -o ) | Directory to ouput processed files to. Setting the output path to be the same as the input path will overwrite existing files. |
--alphabet | Custom sequence of characters to use when encoding.
By default, selector names will be encoded using the following base 62 string: "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ" |
--start-index | Index to start incrementing and encoding from.
By default, this will begin from 0 (essentially a if using the default alphabet). |