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 令牌同时包含五个文字属性,避免组件分别拼凑字段。

json
{
  "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 引用改到新路径。

验收时依次确认以下三件事:

  1. JSON 可以解析,所有 {...} 引用都指向存在的令牌,且没有循环引用。
  2. 三种语义样式实际解析为预期的字号、字重、行高和字间距;特别检查 lineHeight 是否仍为倍数。
  3. 至少检查设置页、任务详情页和帮助面板三处使用位置,确认只有预期的组件随变更更新,且中英文混排未出现裁切。

通过这两种改动后,基础值可集中维护,语义角色也能按使用范围独立演进。

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

目录与阅读设置

阅读设置

17

记录一个想法

如何设计语义化的排版设计令牌

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

登录哪都通