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,直接使用浏览器打开即可。

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,但后面三个名称始终引用同一个值,也没有任何独立调整需求。

判断组件层是否值得保留,可以使用下面三项条件:

  1. 组件是否需要独立调整? 如果按钮主色需要与同样使用主要操作色的其他控件分离,可以建立 button.primary.background。
  2. 组件是否存在专属状态或变体? 如主按钮、次按钮、危险按钮具有不同的背景规则,组件层可以分别管理其属性映射。
  3. 别名是否带来真实的变更边界? 如果某个组件 Token 永远只转发一个语义值,且没有独立覆盖计划,可以暂时让组件直接引用语义层。

因此,三层是职责模型,不是必须为每个属性创建三个名称的硬性规定。仅有两个用途的简单界面,可能采用基础层与语义层就已经足够;具有多个品牌、主题和组件变体的设计系统,则更适合引入明确的组件层。

用一次改色任务验收分层

完成命名和引用后,可以通过一个可重复的小测试确认设计是否符合预期。

  1. 保持 HTML 与 .primary-button 的样式不变,只把浅色主题的 --color-action-primary 从 var(--palette-blue-600) 改为 var(--palette-blue-300)。
  2. 刷新页面,确认浅色按钮背景由 #2563EB 变为 #93C5FD,深色按钮保持不变。由于背景变浅,还应重新检查文字对比度,不能直接把这个改动当成可发布的配色。
  3. 恢复原值,再把 .primary-button 中的 --button-primary-bg 暂时改为 var(--palette-blue-600),确认深色按钮也变成较深的蓝色。这能够复现绕过语义层的错误。
  4. 恢复正确引用,检查所有 Token:基础层不引用上层;语义层引用基础层;组件层引用语义层或必要的基础属性;不存在循环引用和无意义的多重别名。

最后,应形成一份简短的映射清单,至少记录 Token 名称、所属层级、引用目标、主题覆盖范围和使用组件。团队评审时可以直接从一个组件槽位向上追踪到实际颜色值,也能够明确一次改色应发生在哪一层。

当修改基础色不会意外改变无关语义、修改语义映射能够影响所有预期使用方、修改组件映射又不会污染全局语义时,这套三层分工就达到了可检查、可交付的状态。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

基础、语义、组件三层如何分工

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通