UI 视觉设计 / 系统课时
建立 Design Token
建立 Design Token
本篇解决设计规范无法统一维护的问题,通过建立 Design Token 将颜色、字体、间距、圆角、阴影等视觉决策转换为稳定变量。完成后,设计稿和代码可以共享同一套命名体系。
学习目标
- 理解 Design Token 的作用和命名原则
- 掌握基础 Token 与语义 Token 的区别
- 能建立适合团队维护的 Token 结构
Design Token 的核心作用
Design Token 是设计系统中的最小可复用决策单元。它不是简单保存颜色值,而是保存“这个值代表什么意义”。
例如直接写 #1677ff 只能表达一个颜色,而 color-action-primary 表达的是主要操作颜色。未来品牌升级时,只需要修改 Token 映射,不需要逐个调整组件。
从基础值到语义变量
Token 通常分为两层。
基础 Token 保存原始设计值:
json
{
"blue-600": "#1677ff",
"gray-900": "#1f2937",
"space-4": "16px"
}预期结果
text
基础 Token 保存颜色、尺寸等原始规范,作为统一资源来源。语义 Token 描述使用场景:
json
{
"color-text-primary": "{gray-900}",
"color-action-primary": "{blue-600}",
"spacing-component-gap": "{space-4}"
}预期结果
text
组件通过语义名称引用设计意图,不直接依赖具体数值。基础 Token 适合设计维护,语义 Token 适合产品开发。两者结合可以兼顾灵活性和可理解性。
建立命名规则
好的 Token 命名应该描述用途,而不是描述外观。
推荐结构:
CODE
类别-对象-状态-属性例如:
CODE
color-button-primary-hover
radius-card-medium
shadow-modal-default不推荐:
CODE
blue-button
large-radius因为这些名称绑定了当前实现。当设计变化时,名称会失去意义。
在代码中使用 Token
前端项目通常会把 Token 输出为 CSS 变量:
css
:root {
--color-action-primary: #1677ff;
--color-text-primary: #1f2937;
--radius-medium: 8px;
--space-md: 16px;
}
.card {
color: var(--color-text-primary);
border-radius: var(--radius-medium);
padding: var(--space-md);
}预期结果
text
.card 使用统一颜色、圆角和间距变量,修改 Token 后相关组件同步变化。Token 设计边界
不是所有数值都需要成为 Token。只有具有复用价值、需要统一管理或未来可能变化的设计决策才应该抽象。
例如某个特殊插图的单独尺寸,不一定需要进入全局 Token;而按钮高度、页面间距、品牌颜色通常应该进入系统。
本课总结
- Design Token 将视觉决策转化为可维护变量,是设计和代码协作的基础。
- 语义命名比颜色名称更稳定,可以减少设计变化带来的修改成本。
- Token 抽象需要控制范围,只提取真正具有复用价值的规则。
下一课预告
下一课将继续扩展组件库建设,学习如何利用 Token 构建稳定、一致且可扩展的 UI 组件。
按自己的节奏,确认真正理解。