Comment on page
With PostCSS
npm i -D @fullhuman/postcss-purgecss
In
postcss.config.js:const purgecss = require('@fullhuman/postcss-purgecss')
module.exports = {
plugins: [
purgecss({
content: ['./**/*.html']
})
]
}
Using PostCSS API:
const purgecss = require('@fullhuman/postcss-purgecss')
postcss([
purgecss({
content: ['./src/**/*.html']
})
])
See [PostCSS] docs for examples for your environment.
All of the options of PurgeCSS are available to use with the plugins. You will find below the main options available. For the complete list, go to the PurgeCSS documentation website.
Type:
string | ObjectYou can specify content that should be analyzed by PurgeCSS with an array of filenames or globs. The files can be HTML, Pug, Blade, etc.
Type:
Array<Object>PurgeCSS can be adapted to suit your needs. If you notice a lot of unused CSS is not being removed, you might want to use a custom extractor. More information about extractors here.
Type:
Array<string>You can whitelist selectors to stop PurgeCSS from removing them from your CSS. This can be accomplished with the options whitelist and whitelistPatterns.
Type:
Array<RegExp>You can whitelist selectors based on a regular expression with whitelistPatterns.
Type:
boolean Default value: falseIf you are using a CSS animation library such as animate.css, you can remove unused keyframes by setting the keyframes option to true.
Type:
boolean Default value: falseIf there are any unused @font-face rules in your css, you can remove them by setting the fontFace option to true.
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
Last modified 4yr ago