我所理解的 UnoCSS 最佳实践(6):工具类、任意值与任意属性怎么选
- 为什么选择 UnoCSS
- CSS 如何减少重复
- 语义类名与工具类的工程实践
- Tailwind CSS 与 UnoCSS 的兼容边界
- Wind3 与 Wind4 的区别与迁移
- 工具类、任意值与任意属性怎么选(当前)
- 利用 Lint 规范写法
同一条 padding: 8px 18px,在 UnoCSS 里有几种看起来都能用的写法。[padding:8px_18px] 直接写属性和值,p-[8px_18px] 借用工具类前缀,py-8px px-18px 则拆成两个工具类。怎么选,取决于生成的 CSS 是否保留了同一个布局约定。
示例用 UnoCSS 66.12.0 的 Wind4 和 directives transformer。转换 @apply 时,UnoCSS 先解析 token,再把声明写进当前选择器。在模板里用同一套工具类,也可以用相同的方法检查它们是否等价。
先找等价的普通工具类
LoL 职业库用 [overscroll-behavior:contain] 控制滚动容器。在当前预设中,overscroll-contain 生成相同的 overscroll-behavior: contain。百分比也可以直接写进宽度工具类,例如 w-13% 生成 width: 13%。
| 原写法 | 工具类 | Wind4 生成的声明 |
|---|---|---|
[overscroll-behavior:contain] |
overscroll-contain |
overscroll-behavior: contain |
[width:13%] |
w-13% |
width: 13% |
[min-width:0] |
min-w-0px |
min-width: 0 |
[min-width:0] |
min-w-0 |
min-width: calc(var(--spacing) * 0) |
这里优先用 min-w-0px。它直接输出零值,在只加载组件样式时也能工作。选用 min-w-0 则要确保同一份页面样式里提供了 --spacing。
用任意值保留属性
当一个值需要多个参数,先试试同一属性的任意值工具类。这条写法生成 padding: 8px 18px。
.error-action {
@apply p-[8px_18px];
}
在 Wind4 中,py-8px px-18px 生成的是 padding-block: 8px 和 padding-inline: 18px。横排界面里常常看不出区别,换成纵向书写模式时,轴向会跟着书写方向变化。保留物理方向的约定时,用 p-[8px_18px] 就能继续表达整条简写。
同样的选择也适用于 m-[5px_0_0]、gap-[12px_24px] 和 grid-cols-[repeat(3,_1fr)]。遇到有多种解释的前缀,要把类型写清楚,例如 text-[length:var(--app-font-size-body)] 生成字号,而 text-$app-font-size-body 在这套预设里会生成颜色。
用任意属性保留重置范围
有些工具类只能覆盖原属性的一部分。按实际生成结果决定是否保留 [属性:值]。
| 原写法 | 候选工具类 | 差异 |
|---|---|---|
[background:var(--surface)] |
bg-$surface |
后者只设置背景色,原声明会重置其他背景子属性 |
[border:0] |
border-0 |
后者只设置边框宽度 |
[text-decoration:underline] |
underline |
后者只设置装饰线 |
[transform:rotate(180deg)] |
rotate-180 |
需要比较整体变换与工具类组合机制 |
字体、边框、动画等复合写法也要看实际属性。比如 border-[1px_solid_var(--border)] 在这套配置里被解释为 border-color。需要保留整条边框简写时,继续写 [border:1px_solid_var(--border)]。
从单个类核对到生产构建
先用项目配置展开原 token 和候选 token,比较属性、值、重要性和额外的变量或声明。再编译完整项目,对照同一选择器和条件下的 CSS。即使单个类展开一致,工具类的排序仍可能改变简写和子属性的覆盖关系。Vue 的 scoped ID 和文件名哈希可能随源码重新生成,比较时把这些生成标识单独处理。
Stylelint 可以提示已知的等价写法。Wind4 项目启用 sheng/unocss-prefer-equivalent-utility 后,w-[50%] 会提示改成 w-50%,[min-inline-size:0] 会提示改成 min-inline-0px。单变量引用由 sheng/unocss-prefer-css-var-shorthand 检查。项目的实际预设、自定义规则和整块样式的层叠仍由构建验证。具体配置见《利用 Lint 规范写法》。