クラスコンパイルトランスフォーマー

複数のクラスを1つのクラスにコンパイルします。Windi CSSのコンパイルモードと@UltraCakeBakeryによるissue #948に触発されました。

インストール

::: code-group

pnpm add -D @unocss/transformer-compile-class

yarn add -D @unocss/transformer-compile-class

npm install -D @unocss/transformer-compile-class

bun add -D @unocss/transformer-compile-class

:::

import transformerCompileClass from '@unocss/transformer-compile-class'
import { defineConfig } from 'unocss'

export default defineConfig({
  // ...
  transformers: [
    transformerCompileClass(),
  ],
})

::: tip このプリセットはunocssパッケージに含まれており、そこからインポートすることもできます:

import { transformerCompileClass } from 'unocss'

:::

使用方法

クラス文字列の先頭に:uno:を追加して、コンパイル対象としてマークします。

例えば:

<div class=":uno: text-center sm:text-left">
  <div class=":uno: text-sm font-bold hover:text-red" />
</div>

次のようにコンパイルされます:

<div class="uno-qlmcrp">
  <div class="uno-0qw2gr" />
</div>

.uno-qlmcrp {
  text-align: center;
}
.uno-0qw2gr {
  font-size: 0.875rem;
  line-height: 1.25rem;
  font-weight: 700;
}
.uno-0qw2gr:hover {
  --un-text-opacity: 1;
  color: rgb(248 113 113 / var(--un-text-opacity));
}
@media (min-width: 640px) {
  .uno-qlmcrp {
    text-align: left;
  }
}

オプション

オプションを使用して、コンパイルクラスのトリガー文字列とプレフィックスを設定できます。詳細はタイプを参照してください。

ツール

ESLint

プロジェクト全体でクラスコンパイルトランスフォーマーを強制するためのeslintルールがあります: @unocss/enforce-class-compile

使用方法:

{
  "plugins": ["@unocss"],
  "rules": {
    "@unocss/enforce-class-compile": "warn"
  }
}

ライセンス

• MIT License © 2021-PRESENT Anthony Fu