UI 视觉设计 / 系统课时
基础、语义、组件三层如何分工
基础、语义、组件三层如何分工
同一颗“提交订单”按钮需要适配浅色、深色和不同品牌主题。如果把颜色数值、界面用途与组件样式混在一起,改动一次品牌色就可能牵动大量组件。本篇通过一条完整的按钮颜色引用链,明确三层 Token 的职责,并判断什么时候需要组件层、什么时候应该减少抽象。
学习目标
- 区分 Primitive、Semantic、Component Token 的职责和引用方向。
- 用主按钮实例建立基础色、语义色与组件色的双主题映射。
- 识别直接引用基础色、重复命名和过度分层的问题。
三层分别管理什么
Design Token 是具有稳定名称的设计决策值,可以表示颜色、间距、圆角、字号等属性。三层划分依据的是 Token 承担的职责,而不是文件数量。
| 层级 | 示例 | 负责回答的问题 |
|---|---|---|
| Primitive(基础层) | palette.blue.600 = #2563EB |
系统有哪些可用的基础值? |
| Semantic(语义层) | color.action.primary |
这个颜色在界面中承担什么职责? |
| Component(组件层) | button.primary.background |
主按钮的背景应该引用哪个角色? |
Primitive Token 只描述数值,不描述用途。 例如 palette.blue.600 表示调色板中的某个蓝色,不能仅凭名称判断它是按钮背景、链接文字还是焦点边框。一个色阶通常可以被多个语义角色复用。
Semantic Token 表达界面意图。 color.action.primary 表示主要操作颜色。它在浅色主题下可以引用 palette.blue.600,在深色主题下可以引用 palette.blue.300。使用方不需要知道实际 HEX 值,也不应该根据色号推断用途。
Component Token 表达组件的具体属性槽位。 button.primary.background 表示主按钮背景,它可以引用 color.action.primary。当按钮需要独立于其他主要操作控件调整时,只修改组件映射即可,不必改变全局语义。
用主按钮建立完整引用链
假设产品有浅色和深色两套主题,要求主按钮始终清晰可见。首先准备四个基础值,再为两个主题分别配置语义映射。
| Token | 浅色主题 | 深色主题 |
|---|---|---|
color.action.primary |
palette.blue.600 |
palette.blue.300 |
color.on.action |
palette.white |
palette.slate.900 |
button.primary.background |
color.action.primary |
color.action.primary |
button.primary.text |
color.on.action |
color.on.action |
其中,基础值分别为 palette.blue.600 = #2563EB、palette.blue.300 = #93C5FD、palette.white = #FFFFFF、palette.slate.900 = #0F172A。

这里需要分清两件事:
- 语义映射随主题改变。 浅色主题使用较深的蓝色搭配白字,深色主题使用较浅的蓝色搭配深色文字。
- 组件引用保持不变。 两种主题下,主按钮始终引用相同的语义名称,而不是维护两套按钮实现。
这使得主题切换不必修改按钮代码。如果将来品牌主色从蓝色调整为紫色,只需调整对应的基础色和语义映射;组件层仍然描述主按钮的背景与文字职责。
用 CSS 验证三层映射
下面用浏览器原生 CSS 自定义属性实现最小示例,不依赖任何框架。将代码保存为 index.html,直接使用浏览器打开即可。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>Design Token 三层映射</title>
<style>
:root {
/* 基础层:只保存颜色数值 */
--palette-blue-600: #2563eb;
--palette-blue-300: #93c5fd;
--palette-white: #ffffff;
--palette-slate-900: #0f172a;
}
/* 语义层:不同主题映射不同的基础值 */
[data-theme="light"] {
--color-action-primary: var(--palette-blue-600);
--color-on-action: var(--palette-white);
--color-surface: var(--palette-white);
}
[data-theme="dark"] {
--color-action-primary: var(--palette-blue-300);
--color-on-action: var(--palette-slate-900);
--color-surface: var(--palette-slate-900);
}
.demo {
background: var(--color-surface);
padding: 16px;
}
.primary-button {
/* 组件层:在组件上解析当前主题的语义值 */
--button-primary-bg: var(--color-action-primary);
--button-primary-text: var(--color-on-action);
background: var(--button-primary-bg);
color: var(--button-primary-text);
border: 0;
border-radius: 8px;
padding: 12px 16px;
}
</style>
</head>
<body>
<section class="demo" data-theme="light">
<button class="primary-button">提交订单</button>
</section>
<section class="demo" data-theme="dark">
<button class="primary-button">提交订单</button>
</section>
</body>
</html>预期结果:页面上下显示两块区域。浅色区域中的按钮背景为 #2563EB、文字为白色;深色区域中的按钮背景为 #93C5FD、文字为 #0F172A。两个按钮使用完全相同的 HTML 类名和组件样式。
可以通过浏览器开发者工具检查结果:右键按钮选择“检查”,在 Computed(计算后样式)中查看 background-color 和 color。浅色按钮应分别得到 rgb(37, 99, 235) 和 rgb(255, 255, 255);深色按钮应分别得到 rgb(147, 197, 253) 和 rgb(15, 23, 42)。
注意组件别名定义在 .primary-button 上,而不是统一定义在 :root 上。这是为了让组件别名在当前主题上下文中解析语义值。CSS 自定义属性具有继承和计算时机规则,如果在根元素提前计算组件别名,局部深色主题可能无法覆盖最终颜色。
识别直接引用与过度分层
第一种常见错误是让业务组件直接引用基础值。例如将按钮背景固定为 palette.blue.600,或者在 CSS 中直接使用 var(--palette-blue-600)。
这种写法在单一主题下看似正常,但组件绕过了语义层。深色主题即使重新定义 color.action.primary,按钮仍然可能使用原来的蓝色。修复方法是让组件背景引用 color.action.primary,将主题差异集中在语义映射中。
第二种错误是所有属性都强制经过三层,甚至为同一个用途创建多次别名。例如同时建立 color.action.primary、color.button.primary、button.primary.color 和 button.primary.background,但后面三个名称始终引用同一个值,也没有任何独立调整需求。
判断组件层是否值得保留,可以使用下面三项条件:
- 组件是否需要独立调整? 如果按钮主色需要与同样使用主要操作色的其他控件分离,可以建立
button.primary.background。 - 组件是否存在专属状态或变体? 如主按钮、次按钮、危险按钮具有不同的背景规则,组件层可以分别管理其属性映射。
- 别名是否带来真实的变更边界? 如果某个组件 Token 永远只转发一个语义值,且没有独立覆盖计划,可以暂时让组件直接引用语义层。
因此,三层是职责模型,不是必须为每个属性创建三个名称的硬性规定。仅有两个用途的简单界面,可能采用基础层与语义层就已经足够;具有多个品牌、主题和组件变体的设计系统,则更适合引入明确的组件层。
用一次改色任务验收分层
完成命名和引用后,可以通过一个可重复的小测试确认设计是否符合预期。
- 保持 HTML 与
.primary-button的样式不变,只把浅色主题的--color-action-primary从var(--palette-blue-600)改为var(--palette-blue-300)。 - 刷新页面,确认浅色按钮背景由
#2563EB变为#93C5FD,深色按钮保持不变。由于背景变浅,还应重新检查文字对比度,不能直接把这个改动当成可发布的配色。 - 恢复原值,再把
.primary-button中的--button-primary-bg暂时改为var(--palette-blue-600),确认深色按钮也变成较深的蓝色。这能够复现绕过语义层的错误。 - 恢复正确引用,检查所有 Token:基础层不引用上层;语义层引用基础层;组件层引用语义层或必要的基础属性;不存在循环引用和无意义的多重别名。
最后,应形成一份简短的映射清单,至少记录 Token 名称、所属层级、引用目标、主题覆盖范围和使用组件。团队评审时可以直接从一个组件槽位向上追踪到实际颜色值,也能够明确一次改色应发生在哪一层。
当修改基础色不会意外改变无关语义、修改语义映射能够影响所有预期使用方、修改组件映射又不会污染全局语义时,这套三层分工就达到了可检查、可交付的状态。