UI 视觉设计 / 系统课时
把颜色转换为 Design Token
把颜色转换为 Design Token
本篇解决颜色在设计稿与代码中难以统一的问题,通过建立 Primitive、Semantic、Component 三级 Token,把具体色值转换为可复用的设计语言,让主题切换和长期维护更稳定。
学习目标
- 理解三级颜色 Token 的职责边界
- 学会将颜色值映射为具有语义的变量
- 能在设计与前端实现中共享同一套颜色系统
为什么需要颜色 Token
直接在界面中填写十六进制颜色会快速产生混乱。同一个蓝色可能同时表示品牌、按钮、链接和提示状态,当需求变化时,很难判断哪些地方应该一起调整。
Design Token 的核心作用是把视觉决策从具体数值中抽离出来。颜色不再只是 #2563EB 这样的值,而是拥有明确用途的系统变量。
建立三级颜色结构
颜色 Token 通常分为三个层级。
| 层级 | 作用 | 示例 |
|---|---|---|
| Primitive Token | 保存原始色值 | blue-600、gray-900 |
| Semantic Token | 表达界面含义 | color-primary、text-secondary |
| Component Token | 服务具体组件 | button-primary-bg |
Primitive 负责管理色板,Semantic 负责表达设计意图,Component 负责处理组件特殊需求。这样修改品牌色时,不需要逐个查找页面颜色。
定义颜色 Token 示例
下面是一个简化的 Token 定义方式,实际项目可以根据工具链转换为 CSS 变量或代码常量。
json
{
"color": {
"blue": {
"600": "#2563EB"
},
"gray": {
"900": "#111827"
},
"primary": {
"default": "{color.blue.600}"
},
"text": {
"main": "{color.gray.900}"
}
}
}预期结果
text
Primitive 保存具体颜色值,Semantic 引用 Primitive,界面代码只消费语义名称。Token 使用边界
不要让 Semantic Token 直接暴露过多视觉细节。例如按钮组件不应该直接依赖 blue-600,而应该使用 button-primary-background。这样组件可以独立适配深色模式、品牌升级或状态变化。
设计 Token 也不是简单增加变量数量。只有稳定、重复出现并且具有业务意义的颜色才值得抽象。
本课总结
- Primitive、Semantic、Component 三级结构可以分离颜色值、设计意图和组件实现。
- 颜色 Token 让设计稿和代码拥有统一语言,降低维护成本。
- Token 应该表达稳定语义,而不是复制所有视觉细节。
下一课预告
下一课将通过实际页面重构,分析混乱配色的问题,并建立完整的颜色系统。
按自己的节奏,确认真正理解。