UI 视觉设计 / 系统课时
区分品牌、明暗和密度维度
区分品牌、明暗和密度维度
同一套按钮若要服务两个品牌、浅深两种外观和两档布局密度,直接复制八套 Token 会让维护成本迅速增加。本课把主题拆成三个可独立切换的维度,明确变量归属、组合规则与验收方法,最终得到可扩展的主题矩阵。
学习目标
- 区分 Brand、Color Mode 和 Density 各自负责的设计变化。
- 使用独立维度组织 Token,并计算完整的主题组合矩阵。
- 通过实际切换案例验证颜色、尺寸和品牌属性不会相互干扰。
将三个变化维度分开
主题维度是运行时或设计工具中可以独立选择的一组状态。判断是否应该拆成独立维度,可以固定其他设置,只改变当前设置,观察哪些属性确实需要更新。
以一个包含 Atlas 和 Nova 两个品牌的管理后台为例,先定义三个维度:
| 维度 | 可选值 | 负责的变化 | 不应该控制 |
|---|---|---|---|
| Brand | Atlas、Nova | 品牌主色、品牌字体等 | 页面明暗、控件密度 |
| Color Mode | Light、Dark | 背景、文字、边框、状态颜色 | 品牌身份、控件高度 |
| Density | Comfortable、Compact | 控件高度、间距、内边距 | 品牌颜色、明暗模式 |
这三个维度各自回答一个问题:当前属于哪个品牌、使用哪种明暗外观、界面需要多紧凑。
例如,用户从 Atlas 切换到 Nova,不意味着界面必须从 Light 切换到 Dark;用户从 Comfortable 切换到 Compact,也不应该改变按钮的品牌颜色。
实际建模时,可以在项目主题配置中约定 brand、colorMode 和 density 三个字段。它们是项目自定义的主题属性,不是 Figma 内置的固定字段名。
为 Token 指定影响维度
分离主题维度后,需要为每类 Token 指定负责赋值的维度。组件应继续引用稳定的语义名称,而不是直接依赖某个品牌与模式组合的专用名称。
以下采用一套示例命名约定,数值单位为 CSS 像素:
| Token | 依赖维度 | 示例规则 |
|---|---|---|
semantic.surface.canvas |
Color Mode | Light 为 #FFFFFF,Dark 为 #0F172A |
semantic.text.primary |
Color Mode | Light 为 #0F172A,Dark 为 #F8FAFC |
semantic.action.primary |
Brand × Color Mode | 按品牌及明暗选择主操作色 |
component.button.height |
Density | Comfortable 为 48px,Compact 为 40px |
component.button.paddingInline |
Density | Comfortable 为 16px,Compact 为 12px |
component.button.primary.background 可以引用 semantic.action.primary。因此组件不必知道当前品牌名称,只需要消费已经解析的语义值。
这里有一个容易混淆的地方:维度独立,不代表每个 Token 只能依赖一个维度。 品牌主色在浅色与深色背景上可能需要采用不同色阶,以保持对比度,所以 semantic.action.primary 可以同时依赖 Brand 和 Color Mode。
但这种双维度映射不能成为随意混合配置的理由。按钮高度只依赖 Density,就不应该为 Atlas 和 Nova 分别复制一份相同的高度定义。

填写八种主题组合矩阵
假设 Brand 有 2 个值、Color Mode 有 2 个值、Density 有 2 个值,完整组合数量就是 2 × 2 × 2 = 8。
为了得到可检查的结果,先规定四组品牌与明暗配色:Atlas 在 Light 下使用 #2563EB,在 Dark 下使用 #93C5FD;Nova 在 Light 下使用 #6D28D9,在 Dark 下使用 #C4B5FD。
再将密度规则叠加进去,得到主按钮的完整验收矩阵:
| Brand | Color Mode | Density | 按钮背景 | 高度 |
|---|---|---|---|---|
| Atlas | Light | Comfortable | #2563EB |
48px |
| Atlas | Light | Compact | #2563EB |
40px |
| Atlas | Dark | Comfortable | #93C5FD |
48px |
| Atlas | Dark | Compact | #93C5FD |
40px |
| Nova | Light | Comfortable | #6D28D9 |
48px |
| Nova | Light | Compact | #6D28D9 |
40px |
| Nova | Dark | Comfortable | #C4B5FD |
48px |
| Nova | Dark | Compact | #C4B5FD |
40px |
在这组示例中,主按钮文字在 Light 模式下使用 #FFFFFF,在 Dark 模式下使用 #0F172A。水平内边距由 Density 控制,分别为 16px 和 12px。
例如,选择 Atlas、Dark、Compact,解析结果应为:按钮背景 #93C5FD、文字 #0F172A、高度 40px、水平内边距 12px。
如果仅将 Density 改为 Comfortable,背景与文字颜色完全不变,高度变为 48px,水平内边距变为 16px。
八种组合不等于八套独立维护的源文件。 维护时可以将品牌与明暗配色作为二维映射,将密度尺寸作为独立映射,再在组件消费阶段组合结果。以后增加第三个品牌,只需补充新品牌在两种 Color Mode 下的配色,而不必重新定义已有的密度数值。
验证切换是否发生维度串扰
建立主题矩阵后,需要用同一组界面组件测试全部八种组合。建议至少包含主按钮、输入框、内容卡片和状态提示,以便同时覆盖颜色、尺寸与语义状态。
按以下顺序进行验收:
- 固定 Atlas 和 Dark,仅切换 Comfortable、Compact。按钮背景必须始终为
#93C5FD,高度应在 48px 与 40px 之间变化。 - 固定 Atlas 和 Compact,仅切换 Light、Dark。按钮高度必须保持 40px,背景应在
#2563EB与#93C5FD之间变化。 - 固定 Light 和 Comfortable,仅切换 Atlas、Nova。主按钮背景应从
#2563EB变为#6D28D9,页面明暗和按钮高度保持不变。 - 检查八种组合的文字与背景对比度。按照 WCAG 2.2 的 AA 级标准,普通文字通常至少达到 4.5:1,大号文字至少达到 3:1;需要视觉识别的界面组件边界与相邻颜色通常应满足 3:1 的非文本对比度要求。
- 对触控端单独检查交互目标尺寸。示例中的 40px 紧凑按钮面向桌面界面,不应未经检查就直接作为移动端触控目标尺寸。
最常见的错误,是为了让某一组合快速生效,直接新增 atlas-dark-compact-button-bg 一类专用 Token。这样的名字混合了三个维度,下一次调整密度时很容易误改颜色配置。
正确做法是让按钮始终引用 semantic.action.primary,让密度尺寸由独立的组件尺寸 Token 负责。若新增品牌缺少 Dark 配色映射,应在主题验收中明确报告缺失,而不是静默套用 Light 的文字颜色或背景颜色。
验收通过的标准很具体:八种组合都能解析出完整样式,单独切换一个维度时,只改变该维度负责的属性;所有确实需要跨维度映射的 Token 都有明确覆盖规则和检查结果。