设计令牌:概述
设计令牌是所有 UI 元素的基础构建单元。同一套令牌贯穿设计、工具和代码。
- 设计令牌指向样式值,例如颜色、字体和度量值
- 使用设计令牌代替硬编码值
- 每个令牌的名称都反映其用途或使用位置(例如,md.comp.fab.primary.container.color 设置 FAB 的容器颜色)
- 即使令牌的最终值发生变化,其名称和用途也保持不变
- Material Design 有三类设计令牌:引用令牌、系统令牌 和 组件令牌

资源
| 类型 | 链接 | 状态 |
|---|---|---|
| 设计 | Design Kit(Figma) | 可用 |
| Material Theme Builder Figma 插件 | 可用 | |
| 实现 | Material 基线主题与令牌(DSP) | 可用 |
什么是设计令牌?
设计令牌是构成设计系统视觉风格的小型、可复用设计决策。令牌以含义明确的名称代替静态值。
一个设计令牌由两部分组成:
- 类似代码的名称,例如 md.ref.palette.secondary90
- 关联值,例如 #E8DEF8
令牌值可以是颜色、字体、度量值,甚至另一个令牌。

设计令牌能将原本缺乏明确关联的样式选择以有意义的方式联系起来。
例如,如果设计师的设计稿和工程师的实现都引用同一个表示“次色容器颜色”的令牌,那么他们就能确信设计与实现使用的是同一种颜色。即使分配给该令牌的十六进制值发生更新,这一点依然成立。

为什么设计令牌很重要?
设计令牌使设计系统能够拥有单一可信来源——一个记录样式选择并可跟踪变更的仓库。
由于令牌可复用且以用途为导向,它们可以为主题和上下文定义系统级更新。例如,你可以使用令牌系统化地应用高对比度配色方案以提高可视性,或调整字阶以确保文本在电视屏幕上清晰可读。
通过在设计和实现中使用令牌,样式更新会在整个产品或产品系列中一致传播。令牌还帮助设计师和工程师“说同一种语言”,减少从设计移交到实现过程中的误解。

判断设计令牌是否适合你
设计令牌在以下情况下最有用:
- 你计划更新产品设计,或正在从零开始构建产品
- 你的设计系统应用于一系列产品或平台
- 你希望日后能轻松维护或更新样式
- 你希望充分利用 Material Design 系统,包括动态色彩等功能
设计令牌在以下情况下用处较小:
- 你的现有应用使用硬编码值,且未来一两年内不太可能更改
- 你的产品没有设计系统
设计令牌与 Material Design
过去,Material 样式主要通过指南、设计文件、工具和平台专属组件库来传递。
借助设计令牌,你现在可以下载、自定义和应用 Material 样式,并将其集成到设计和开发流程中。
设计令牌以平台无关、可共享的格式记录设计决策。

本网站会在交互式模块中列出令牌。
这些模块让你快速查询令牌中存储的颜色、字体、字号、字重等默认基准值。它们还展示角色、对应的系统令牌、引用令牌与存储的预设值之间的关系。

你还会在组件文档的规格标签页中看到令牌。
令牌首先按状态(启用、禁用、悬停等)分组,然后按元素分组。元素是指令牌或值所应用到的组件部位,例如容器或标签文本。
表格包含以下列:
- 名称——令牌适用的组件样式属性,例如颜色或字体
- 令牌 ID——定义组件样式属性的令牌
- 描述——可选的补充说明
- 上下文/值——令牌在特定上下文中存储的值

如何使用令牌模块
假设你需要验证填充按钮标签文本的颜色角色。
导航到“常见按钮 > 规格”,找到填充按钮的令牌模块,并在“元素”下搜索“标签文本”令牌。
复制颜色令牌并粘贴到代码中,或将其与 Figma 中的颜色角色进行比较。

令牌名称的组成部分
令牌名称的各个部分用点号分隔,并按从最通用信息(“md”)到最具体信息(“on-secondary”)的顺序排列。
- 设计系统中的所有令牌名称都以系统名称开头(例如 Material Design 的“md”)
- 令牌类别的缩写:“ref”表示引用令牌,“sys”表示系统令牌,“comp”表示组件令牌
- 令牌以描述性词语结尾,说明令牌的用途

- 标识所属设计系统
- 标识令牌类别
- 说明令牌用途
设计令牌类别
Material 中的设计令牌分为三类:
- 引用令牌
所有可用令牌及其关联值。 - 系统令牌
决定设计系统整体特征的决策与角色,涵盖从颜色和字体体系到海拔与形状。 - 组件令牌
分配给组件中元素的设计属性,例如按钮图标的颜色。
借助三类设计令牌,团队可以全局更新设计决策,也可以将更改应用于单个组件。

引用令牌
这些令牌构成设计系统中所有可用的样式选项。
它们通常指向静态值——例如十六进制颜色代码或字号——但也可以指向其他引用令牌。引用令牌不会因上下文而改变。
引用令牌以选项列表的形式,为团队提供一套经过认可的颜色、字体体系、度量值等,作为设计起点。
所有引用令牌都以 ref 为前缀。

系统令牌
系统令牌是使设计语言针对特定主题或上下文系统化的决策。
系统令牌定义引用令牌在 UI 中的用途。
主题定制正是在这一层实现的。系统令牌可以根据上下文(例如浅色或深色主题)指向不同的引用令牌。
系统令牌应尽可能指向引用令牌,而不是静态值。
所有系统令牌都以 sys 为前缀。

组件令牌(开发中)
组件令牌表示构成组件所需的元素(如容器、标签文本、图标、状态)及其对应的值(如尺寸、形状、颜色或海拔)。
组件令牌应尽可能指向系统令牌或引用令牌,而不包含十六进制代码等硬编码值。
并非组件的每个样式选择都能表达为令牌,但只要某个设计选择适用于多个用途相似的组件,就应将其定义为令牌。
所有组件令牌都以 comp 为前缀。

上下文
设计令牌可以根据一组条件指向不同的值。这些条件称为上下文,其生成的值称为上下文相关值。
不同上下文的示例包括:设备形态、深色主题、紧凑布局和从右到左的书写系统。
你可以将上下文视为一种标签。如果某个令牌值被标记为深色主题,那么在深色主题上下文中,该值将覆盖默认令牌值。
