PostCSS 插件

危险

如果你使用的是 PostCSS 7 版本，请安装 @fullhuman/postcss-purgecss 3.0.0: npm i -D @fullhuman/postcss-purgecss@3.0.0。 从 4.0 版本开始，此插件仅兼容 PostCSS >=8。

安装

npm i -D @fullhuman/postcss-purgecss postcss

用法

在 postcss.config.js 文件中设置：

const purgecss = require('@fullhuman/postcss-purgecss')

module.exports = {
  plugins: [
    purgecss({
      content: ['./**/*.html']
    })
  ]
}

通过 PostCSS API 调用

const purgecss = require('@fullhuman/postcss-purgecss')
postcss([
  purgecss({
    content: ['./src/**/*.html']
  })
])

有关你的具体使用环境的示例，请参阅 PostCSS 文档。

参数

PurgeCSS 的所有参数都可以在插件中使用。 以下列出了可以使用的主要参数。有关完整列表，请访问 PurgeCSS 文档。

export interface UserDefinedOptions {
  content?: Array<string | RawContent>;
  contentFunction?: (sourceFile: string) => Array<string | RawContent>;
  defaultExtractor?: ExtractorFunction;
  extractors?: Array<Extractors>;
  fontFace?: boolean;
  keyframes?: boolean;
  output?: string;
  rejected?: boolean;
  stdin?: boolean;
  stdout?: boolean;
  variables?: boolean;
  safelist?: UserDefinedSafelist;
  blocklist?: StringRegExpArray;
}

interface RawContent {
  extension: string
  raw: string
}

interface RawCSS {
  raw: string
}

type StringRegExpArray = Array<RegExp | string>;