UI 视觉设计 / 系统课时
如何设计语义化的排版设计令牌
如何设计语义化的排版设计令牌
当设置页、详情页和任务卡片各自写死字号时,同一种正文样式可能被复制十几次,调整后容易出现遗漏。本课用一份可解析的令牌数据,将字号等基础规格与“标题、正文、辅助文字”等语义角色分开,再让组件只引用角色名称。
学习目标
- 区分描述具体数值的基础令牌与描述文字职责的语义令牌。
- 编写包含字号、字重、行高和字间距引用的 Typography Token。
- 根据引用链判断一次修改会影响哪些页面,并完成结果验收。
先列文字角色,再选择基础刻度
假设正在为一个任务管理产品统一排版。先检查页面中的文字功能,而不是按现有组件名称创建样式。本例只保留三种跨页面重复使用的角色:
| 语义角色 | 基础规格 | 使用位置 |
|---|---|---|
| 分组标题 | 24px、600、行高 1.25 | 设置分组、详情分区 |
| 默认正文 | 16px、400、行高 1.5 | 任务描述、帮助说明 |
| 辅助文字 | 14px、400、行高 1.5 | 更新时间、附加说明 |
基础令牌只关心“字号 16px”“字重 400”这样的值,名称可以是 base.size.md、base.weight.regular。语义令牌关心文字承担什么职责,例如 semantic.body.default。不要把 taskCardTitle24 当作公共语义名:组件一改名或换场景,令牌就失去了可复用性。
这里的行高 1.5 是无单位倍数:16px 正文对应约 24px 行盒;字间距统一设为 0px。字号、字重和行高均为本例的初始设计决策,并非适用于所有产品的强制标准。
把规格写成可引用的 Typography Token
将下面内容保存为 typography.tokens.json。数据采用 DTCG 2025.10 格式:$type 指明类型,$value 保存值;花括号包裹的路径表示令牌引用。复合 typography 令牌同时包含五个文字属性,避免组件分别拼凑字段。
{
"base": {
"family": {
"ui": {
"$type": "fontFamily",
"$value": [
"Noto Sans SC",
"PingFang SC",
"Microsoft YaHei",
"sans-serif"
]
}
},
"size": {
"$type": "dimension",
"sm": {
"$value": {
"value": 14,
"unit": "px"
}
},
"md": {
"$value": {
"value": 16,
"unit": "px"
}
},
"lg": {
"$value": {
"value": 24,
"unit": "px"
}
}
},
"weight": {
"$type": "fontWeight",
"regular": {
"$value": 400
},
"semibold": {
"$value": 600
}
},
"leading": {
"$type": "number",
"compact": {
"$value": 1.25
},
"reading": {
"$value": 1.5
}
},
"tracking": {
"normal": {
"$type": "dimension",
"$value": {
"value": 0,
"unit": "px"
}
}
}
},
"semantic": {
"heading": {
"section": {
"$type": "typography",
"$value": {
"fontFamily": "{base.family.ui}",
"fontSize": "{base.size.lg}",
"fontWeight": "{base.weight.semibold}",
"lineHeight": "{base.leading.compact}",
"letterSpacing": "{base.tracking.normal}"
}
}
},
"body": {
"default": {
"$type": "typography",
"$value": {
"fontFamily": "{base.family.ui}",
"fontSize": "{base.size.md}",
"fontWeight": "{base.weight.regular}",
"lineHeight": "{base.leading.reading}",
"letterSpacing": "{base.tracking.normal}"
}
}
},
"label": {
"supporting": {
"$type": "typography",
"$value": {
"fontFamily": "{base.family.ui}",
"fontSize": "{base.size.sm}",
"fontWeight": "{base.weight.regular}",
"lineHeight": "{base.leading.reading}",
"letterSpacing": "{base.tracking.normal}"
}
}
}
}
}其中 dimension 使用带 value 和 unit 的对象;fontWeight 是数值;lineHeight 是无单位 number。例如 semantic.body.default.fontSize 指向 {base.size.md},解析后是 16px,而不是将字符串 {base.size.md} 直接作为 CSS 字号使用。引用必须经过支持 DTCG 格式的解析或转换步骤才能落到平台样式。
让组件只依赖语义角色
一条完整链路是:基础数值提供候选规格,语义令牌组合为文字样式,多个组件再复用同一语义样式。关系复杂时用下图核对引用方向,不要让业务组件绕过中间层直接读取基础字号。

| 页面中的文字 | 绑定的语义令牌 | Figma 文本样式建议名 |
|---|---|---|
| 设置页分组标题、详情页分组标题 | semantic.heading.section |
Heading/Section |
| 任务详情正文、帮助面板正文 | semantic.body.default |
Body/Default |
| 任务更新时间 | semantic.label.supporting |
Label/Supporting |
在 Figma 中以这些角色名称建立文本样式;在前端通过令牌转换流程生成对应的 CSS 或组件样式。Figma 文本样式并不会因为粘贴此 JSON 而自动建立关联,需使用支持该格式的同步工具或项目转换脚本。无论采用哪种工具,都应保证组件保存的是语义角色关系,而不只是复制后的最终数值。
用两种改动验证引用是否合理
先做一次全局正文调整:把 base.size.md 的 value 从 16 改为 18。重新解析令牌后,semantic.body.default 应变为 18px,行高倍数仍为 1.5,对应约 27px;任务详情与帮助面板的正文都应更新。分组标题仍为 24px,辅助文字仍为 14px。
再模拟仅调整某一种语义角色。如果另一个角色也使用 base.size.md,却不应跟着变大,不要直接修改这个共享基础值;可以新增 base.size.bodyLarge(18px),只把目标语义令牌的 fontSize 引用改到新路径。
验收时依次确认以下三件事:
- JSON 可以解析,所有
{...}引用都指向存在的令牌,且没有循环引用。 - 三种语义样式实际解析为预期的字号、字重、行高和字间距;特别检查
lineHeight是否仍为倍数。 - 至少检查设置页、任务详情页和帮助面板三处使用位置,确认只有预期的组件随变更更新,且中英文混排未出现裁切。
通过这两种改动后,基础值可集中维护,语义角色也能按使用范围独立演进。