UI 视觉设计 / 系统课时
归一间距、圆角和边框刻度
归一间距、圆角和边框刻度
把页面里散落的 7px、14px、15px 间距,以及不一致的圆角、边框厚度收敛为可复用刻度,同时保留确有理由的例外。本课会得到一份数值清单、一组符合 DTCG 的 Token 引用和一套可以检查的迁移规则。
学习目标
- 从已有页面中归类间距、尺寸、圆角和描边值,识别重复与异常。
- 定义分开的数值刻度,并把基础值映射到语义与组件 Token。
- 判断例外值是否应该修正、局部保留或提升为组件专属 Token。
先建立现有数值台账
以订单列表、订单详情和设置页为样本,记录容器内边距、元素间距、控件高度、圆角、边框宽度。每个记录至少包含页面、组件、CSS 属性、原始值、出现次数和修改风险;同一处同时有水平与垂直内边距时分开计数。
假设 42 处间距用值中,8px 出现 12 次、16px 出现 17 次、24px 出现 9 次,7px 和 15px 各出现 2 次。先在设计稿中确认这 4 处离散值是否为人工误差,再决定归一;不要仅因接近就批量替换。特别要区分 border-width、图标笔画宽度,以及控件的 height:它们不是同一类刻度。
为四种用途制定独立刻度
下面是适用于普通 Web 产品的初始候选值,而非 DTCG 规定的固定数值。基础刻度按数值命名,业务含义由后续别名承担。
| 类别 | 候选刻度(CSS px) | 典型落点 |
|---|---|---|
间距 space |
0、2、4、8、12、16、24、32、48、64 | 图标与文字 8;卡片内边距 16;区块间距 24 |
圆角 radius |
0、4、8、12、16 | 方角 0;卡片 8;弹窗 12 |
边框厚度 stroke |
0、1、2 | 无边框 0;普通边框 1;强调边框 2 |
固定控件高度 controlHeight |
24、32、40、48、56 | 小型非交互标签 24;常规按钮 40;大型按钮 48 |
间距优先用 4px 节奏,2px 留给紧凑细节;圆角不必跟间距共用名称,即使两者恰好都是 8px。边框 1px 指 CSS 像素,不是一个物理屏幕像素;跨端导出到 Android、iOS 时应由转换层处理目标平台的尺寸单位。
把刻度落到可解析的 Token
依据 DTCG 2025.10 规范,tokens.json 中 dimension 的值由数字 value 与单位 unit 组成,单位只能是 px 或 rem。下面是可独立解析的最小文件示例,只列出本次演示用到的数值;其余刻度可以按相同结构补齐。
{
"$schema": "https://www.designtokens.org/schemas/2025.10/format.json",
"primitive": {
"space": {
"$type": "dimension",
"16": {"$value": {"value": 16, "unit": "px"}},
"24": {"$value": {"value": 24, "unit": "px"}}
},
"radius": {
"$type": "dimension",
"8": {"$value": {"value": 8, "unit": "px"}}
},
"stroke": {
"$type": "dimension",
"1": {"$value": {"value": 1, "unit": "px"}}
},
"controlHeight": {
"$type": "dimension",
"40": {"$value": {"value": 40, "unit": "px"}}
}
},
"semantic": {
"space": {
"containerInset": {"$type": "dimension", "$value": "{primitive.space.16}"}
},
"radius": {
"surface": {"$type": "dimension", "$value": "{primitive.radius.8}"}
},
"stroke": {
"default": {"$type": "dimension", "$value": "{primitive.stroke.1}"}
}
},
"component": {
"card": {
"padding": {"$type": "dimension", "$value": "{semantic.space.containerInset}"},
"radius": {"$type": "dimension", "$value": "{semantic.radius.surface}"},
"borderWidth": {"$type": "dimension", "$value": "{semantic.stroke.default}"}
},
"button": {
"height": {"$type": "dimension", "$value": "{primitive.controlHeight.40}"}
},
"statusBadge": {
"height": {
"$type": "dimension",
"$value": {"value": 22, "unit": "px"},
"$description": "非交互订单状态标签的特例高度"
}
}
}
}生效结果应是卡片内边距 16px、圆角 8px、边框 1px,按钮高度 40px。将 semantic.space.containerInset 的引用由 {primitive.space.16} 改为 {primitive.space.24},再次解析后卡片内边距应变为 24px,其他三项不变。验证时同时检查 $type、引用路径和解析后的单位;不要把 16px 直接写成 dimension 的字符串值。
处理不规则值与组件专属尺寸
判断离散值时按“能否纠正、是否复用、是否具有独立语义”的顺序处理:
- 可纠正的偏差:卡片偶然出现
15px内边距,且与16px视觉一致,设计确认后统一映射到space.16。 - 稳定的组件例外:非交互状态标签因文字行高与版式需保持
22px,保留component.statusBadge.height,在$description记录原因,不新增全局space.22。 - 真正可复用的新值:若
20px在多个不同组件中反复出现且不能由现有刻度替代,先统计使用场景并评审,再补充primitive.space.20;不要直接为一次性页面生成全局 Token。

用对照清单验收迁移
回到原来的 42 处间距记录,逐一填写新 Token 与处理理由。假设 38 处复用现有刻度、4 处异常经设计确认改到最近刻度,则验收时应达到 42/42 有归属、0 处未解释的离散值;别把“视觉看起来差不多”当作完成依据。
分别在 360px 和 1280px 视口检查列表、卡片和弹窗:核对内边距与区块间隔、圆角是否剪裁内容、1px 边框是否清楚,以及按钮文字有无换行。若改动导致内容碰撞或操作目标过小,应优先修组件约束,而非悄悄增加新的全局数值。最后再检查引用无缺失、无循环,并让设计稿和实际样式指向相同的语义名称。