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 组件。

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

目录与阅读设置

阅读设置

17

记录一个想法

建立 Design Token

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

登录哪都通