プログラム API

まず、開発依存関係として PurgeCSS をインストールするところから始めます。

npm install purgecss --save-dev

yarn add purgecss --dev

これで JavaScript ファイル内で PurgeCSS を使用できるようになりました。

以下の例では、PurgeCSS に渡されるオプションは こちら の例と同じものです。結果の purgecssResult はパージされた CSS を含むファイル名のオブジェクトの配列です。

使用法

ES モジュールのインポート構文

import { PurgeCSS } from 'purgecss'
const purgeCSSResult = await new PurgeCSS().purge({
  content: ['**/*.html'],
  css: ['**/*.css']
})

CommonJS の構文

const { PurgeCSS } = require('purgecss')
const purgeCSSResult = await new PurgeCSS().purge({
  content: ['**/*.html'],
  css: ['**/*.css']
})

purgeCSSResult のフォーマット

[
    {
        file: 'main.css',
        css: '/* purged css for main.css */'
    },
    {
        file: 'animate.css',
        css: '/* purged css for animate.css */'
    }
]

result の種類は

interface ResultPurge {
  css: string;
  file?: string;
  rejected?: string[];
  rejectedCss?: string;
}