UI 视觉设计 / 系统课时
拆分组件默认值与状态变量
拆分组件默认值与状态变量
一个主按钮会在默认、悬停、按下、禁用和键盘聚焦时切换外观。如果背景、文字与边框的颜色散落在组件样式里,改品牌色或加深色主题就容易漏改。本篇用一张状态矩阵确定视觉契约,再把共享语义与 Button 专属值拆成可发布的 Token。
学习目标
- 列清 Button 的背景、文字、边框与焦点环在各状态下的取值。
- 判断哪些状态色复用全局语义 Token,哪些保留在组件层。
- 编写符合 DTCG 数据结构的别名,并按状态验证引用结果。
先列状态矩阵,再决定变量数量
以高度 40px、边框宽 1px 的 Primary Button 为例,先固定四种互斥状态;颜色是教学用的一套浅色主题取值,实际项目应按品牌及对比度测试调整。
| 状态 | 背景 | 文字 | 边框 |
|---|---|---|---|
| 默认 | #175CD3 |
#FFFFFF |
#175CD3 |
| 悬停 | #1849A9 |
#FFFFFF |
#1849A9 |
| 按下 | #194185 |
#FFFFFF |
#194185 |
| 禁用 | #EAECF0 |
#667085 |
#EAECF0 |
键盘焦点不是第五套背景色:保留当前可交互状态的背景、文字和边框,只增加 2px 的 #2563EB 外轮廓,轮廓与按钮相距 2px。用 :focus-visible 显示焦点环;禁用时不应再叠加悬停或按下效果。
按复用范围分开语义层和组件层
跨 Button、Tab、工具栏动作共用的含义放语义层,例如 semantic.action.primary.default、semantic.action.primary.hover、semantic.action.onPrimary。禁用底色、禁用文字和焦点环也能复用,分别命名为 semantic.disabled.surface、semantic.disabled.text、semantic.focus.ring。
若深色按下态只属于 Button,就先由 component.button.primary.background.pressed 引用基础色 palette.brand.800,不要为了名称对称而强行建立全局 pressed 语义。圆角 8px、焦点环宽 2px 和偏移 2px 是 Button 的呈现规则,放在组件层。边框颜色跟随对应背景,使用组件内部别名,避免两处手工改值。

用 DTCG 别名落实拆分
下面是可以保存为 tokens.json 的完整示例。颜色采用 DTCG 的 srgb 归一化分量;$value 中的 {路径} 表示引用整个 Token。组件只保存职责和状态,不直接复制默认态的颜色值。
{
"palette": {
"$type": "color",
"brand": {
"600": {"$value": {"colorSpace": "srgb", "components": [0.0902, 0.3608, 0.8275]}},
"700": {"$value": {"colorSpace": "srgb", "components": [0.0941, 0.2863, 0.6627]}},
"800": {"$value": {"colorSpace": "srgb", "components": [0.0980, 0.2549, 0.5216]}}
},
"neutral": {
"0": {"$value": {"colorSpace": "srgb", "components": [1, 1, 1]}},
"200": {"$value": {"colorSpace": "srgb", "components": [0.9176, 0.9255, 0.9412]}},
"500": {"$value": {"colorSpace": "srgb", "components": [0.4, 0.4392, 0.5216]}}
},
"focus": {"$value": {"colorSpace": "srgb", "components": [0.1451, 0.3882, 0.9216]}}
},
"semantic": {
"action": {
"primary": {
"default": {"$value": "{palette.brand.600}"},
"hover": {"$value": "{palette.brand.700}"}
},
"onPrimary": {"$value": "{palette.neutral.0}"}
},
"disabled": {
"surface": {"$value": "{palette.neutral.200}"},
"text": {"$value": "{palette.neutral.500}"}
},
"focus": {"ring": {"$value": "{palette.focus}"}}
},
"component": {
"button": {
"radius": {"$type": "dimension", "$value": {"value": 8, "unit": "px"}},
"primary": {
"background": {
"default": {"$value": "{semantic.action.primary.default}"},
"hover": {"$value": "{semantic.action.primary.hover}"},
"pressed": {"$value": "{palette.brand.800}"},
"disabled": {"$value": "{semantic.disabled.surface}"}
},
"foreground": {
"default": {"$value": "{semantic.action.onPrimary}"},
"disabled": {"$value": "{semantic.disabled.text}"}
},
"border": {
"default": {"$value": "{component.button.primary.background.default}"},
"hover": {"$value": "{component.button.primary.background.hover}"},
"pressed": {"$value": "{component.button.primary.background.pressed}"},
"disabled": {"$value": "{component.button.primary.background.disabled}"}
},
"focusRing": {
"color": {"$value": "{semantic.focus.ring}"},
"width": {"$type": "dimension", "$value": {"value": 2, "unit": "px"}},
"offset": {"$type": "dimension", "$value": {"value": 2, "unit": "px"}}
}
}
}
}
}此文件描述设计值与引用,并不自动实现鼠标或键盘交互。构建工具需要先解析别名,再按项目约定导出 CSS 变量;具体导出的变量名不是 DTCG 规范固定的。注意 $type 在 palette 组中继承,而别名 Token 的类型由目标 Token 推导。
在真实按钮上核对状态优先级
- 让正常态绑定
component.button.primary.background.default、foreground.default和border.default;交互逻辑分别将:hover、:active映射到 hover、pressed,禁用态映射到 disabled。 - 鼠标悬停应看到约
#1849A9,按住鼠标应看到约#194185;给按钮设置disabled后,即使鼠标经过也应保持#EAECF0背景和#667085文字,且不能触发点击处理。 - 用
Tab聚焦可用按钮,应出现2px焦点轮廓和2px间距;焦点轮廓不应覆盖背景或替代边框。浏览器开发者工具的 Computed 面板可核对最终颜色及outline属性。 - 将
palette.brand.600改成另一个值并重新构建:默认背景、默认边框应同步改变;按下态仍引用palette.brand.800,说明组件专属状态与共享默认语义已正确拆分。
如果后来 Input、Tab 等也需要相同的按下反馈,再将该颜色提升为 semantic.action.primary.pressed,并让各组件改用别名。是否提升由语义复用决定,不以多个值偶然相同为依据。