PostCSS

Avertissement

Si vous utilisez PostCSS 7, installez @fullhuman/postcss-purgecss 3.0.0 : npm i -D @fullhuman/postcss-purgecss@3.0.0. À partir de la version 4.0, il est compatible uniquement avec PostCSS >=8.

Installation

npm i -D @fullhuman/postcss-purgecss postcss

Utilisation

Dans postcss.config.js :

import purgeCSSPlugin from '@fullhuman/postcss-purgecss';

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

En utilisant l'API PostCSS :

import purgeCSSPlugin from '@fullhuman/postcss-purgecss';

postcss([
  purgeCSSPlugin({
    content: ['./src/**/*.html']
  })
])

Consultez la documentation de PostCSS pour des exemples adaptés à votre environnement.

Toutes les options de PurgeCSS sont disponibles avec les plugins. Vous trouverez ci-dessous la définition de type des principales options disponibles. Pour la liste complète, consultez le site de documentation de 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>;