跳至內容

編譯類別轉換器

將一組類別編譯成一個類別。靈感來自 Windi CSS 的編譯模式以及 @UltraCakeBakery 提出的議題 #948

安裝

bash
pnpm add -D @unocss/transformer-compile-class
bash
yarn add -D @unocss/transformer-compile-class
bash
npm install -D @unocss/transformer-compile-class
uno.config.ts
ts
import transformerCompileClass from '@unocss/transformer-compile-class'
import { defineConfig } from 'unocss'

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

提示

此預設集包含在 unocss 套件中,您也可以從那裡導入它。

ts
import { transformerCompileClass } from 'unocss'

用法

在類別字串的開頭加上 :uno: 來標記它們以進行編譯。

例如

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

將被編譯成

html
<div class="uno-qlmcrp">
  <div class="uno-0qw2gr"/>
</div>
css
.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

用法

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

許可證

基於 MIT 許可證發布。