指南

什么是 UnoCSS？

UnoCSS 是即时原子 CSS 引擎，旨在灵活和可扩展。核心是不带偏见的，所有的 CSS 实用工具都是通过预设提供的。

例如，您可以通过在本地配置文件中提供规则来定义自定义 CSS 实用工具。

// uno.config.ts
import { defineConfig } from 'unocss'

export default defineConfig({
  rules: [
    ['m-1', { margin: '1px' }],
  ],
})

这将在您的项目中添加一个新的 CSS 实用工具 m-1。由于 UnoCSS 是按需的，在您的代码库中使用它之前它不会起作用。所以假设我们有这样一个组件：

html

<div class="m-1">Hello</div>

m-1 将被检测到，并生成以下 CSS：

css

.m-1 { margin: 1px; }

为了使它更灵活，您可以通过将规则的第一个参数（我们称之为匹配器）更改为 RegExp，并将主体更改为函数来使您的规则动态化，例如：

diff

// uno.config.ts
export default defineConfig({
  rules: [
-    ['m-1', { margin: '1px' }],
+    [/^m-([\.\d]+)$/, ([_, num]) => ({ margin: `${num}px` })],
  ],
})

通过这样做，现在您可以拥有任意的边距实用工具，例如 m-1、m-100 或 m-52.43。再次强调，UnoCSS 只有在您使用它们时才会生成它们。

html

<div class="m-1">Hello</div>
<div class="m-7.5">World</div>

css

.m-1 { margin: 1px; }
.m-7.5 { margin: 7.5px; }

预设

一旦您制定了几条规则，就可以将它们提取到一个预设中，并与他人共享。例如，您可以为公司的设计系统创建一个预设，并与团队共享。

// my-preset.ts
import { Preset } from 'unocss'

export const myPreset: Preset = {
  name: 'my-preset',
  rules: [
    [/^m-([.\d]+)$/, ([_, num]) => ({ margin: `${num}px` })],
    [/^p-([.\d]+)$/, ([_, num]) => ({ padding: `${num}px` })],
  ],
  variants: [/* ... */],
  shortcuts: [/* ... */],
  // ...
}

// uno.config.ts
import { defineConfig } from 'unocss'
import { myPreset } from './my-preset'

export default defineConfig({
  presets: [
    myPreset, // 您自己的预设
  ],
})