UI 视觉设计 / 系统课时
定义文本背景边框的色彩角色
定义文本背景边框的色彩角色
订单工作台切换浅色与深色主题时,常出现正文太淡、卡片层级混乱、输入框边界消失的问题。下面以订单列表为例,为文字、表面和边框建立可复用的语义角色,并用双主题对比度与实际组件检查结果。
学习目标
- 区分主要文字、次要文字、页面背景、容器表面和不同用途的边框。
- 为同一组语义令牌配置 Light、Dark 两套取值,而不修改组件引用。
- 检查文字可读性、容器层级及交互边界是否符合要求。
按职责命名颜色,而不是按色号命名
把颜色角色写成语义令牌,组件只引用用途,不直接引用 gray-600 等基础色编号。本例采用以下分工:
text.primary:订单编号、列表表头、金额等必须首先读到的信息。text.secondary:下单时间、备注、辅助描述;仍需满足正文可读性。surface.page:工作台整页底色;surface.card:订单列表主容器;surface.nested:卡片内筛选条或只读信息区域。border.divider:表格行分隔线;border.control:输入框等需要明确边界的控件;border.focus:键盘聚焦时的可见轮廓。
不要把 text.secondary 同时用于禁用态,也不要用 border.divider 承担输入框唯一的可见边界。不同交互状态需要独立语义,以免将来调整次要文字时连带破坏控件识别。
配置 Light 与 Dark 的角色值
以下数值是一套可复现的订单工作台示例,十六进制颜色直接作为变量值使用;真正交付时,应按实际背景重新核对对比度。
| 语义令牌 | Light | Dark |
|---|---|---|
text.primary |
#17233A |
#F1F5F9 |
text.secondary |
#475569 |
#CBD5E1 |
surface.page |
#F8FAFC |
#0B1220 |
surface.card |
#FFFFFF |
#172033 |
surface.nested |
#F1F5F9 |
#243247 |
border.divider |
#E2E8F0 |
#344256 |
border.control |
#64748B |
#94A3B8 |
border.focus |
#2563EB |
#93C5FD |
在设计工具中建立同名语义变量与 Light、Dark 两个模式。订单编号绑定 text.primary,输入框绑定 border.control,切换主题时只更换模式映射,不逐个编辑组件填充色。这里的变量名是本项目约定的命名方案,不是软件内置名称。
在订单卡片里检查三层表面与两类边界
以宽度约 960 px 的工作台为例:整页使用 surface.page,订单列表卡片使用 surface.card,卡片顶部的筛选区才使用 surface.nested。卡片内边距设为 16 px、内容纵向间距设为 12 px;分隔线和普通输入框轮廓为 1 px,键盘焦点轮廓为 2 px。

分隔线只帮助扫描行内容,不应比订单编号更抢眼;输入框则必须让用户看出它可操作。深色主题的 surface.nested 比 surface.card 略亮,不能简单把浅色方案反相,否则卡片与嵌套区域容易粘连。
用对比度和交互状态验收
按表中颜色计算,与 surface.card 的对比度如下;对比度计算应基于实际前景色与实际承载底色,不能只检查变量色块本身。
| 检查项 | Light | Dark | 判定 |
|---|---|---|---|
| 主要文字 / 卡片 | 15.70:1 | 14.85:1 | 满足普通文字 4.5:1 |
| 次要文字 / 卡片 | 7.58:1 | 10.96:1 | 满足普通文字 4.5:1 |
| 输入框边界 / 卡片 | 4.76:1 | 6.34:1 | 超过关键控件边界参考值 3:1 |
| 装饰分隔线 / 卡片 | 1.23:1 | 1.60:1 | 仅用于辅助分组,不承载唯一状态信息 |
再将次要文字放到 surface.nested 中测试:Light 约为 6.92:1,Dark 约为 8.72:1,均可作为普通正文。使用键盘 Tab 依次进入筛选输入框,确认 2 px 的焦点轮廓可见;分别检查 320 px 视口、200% 缩放和长订单编号,避免换行后文字覆盖边框。
如果某条细线消失不会妨碍辨认内容分组,它可以保持低对比度;如果一条边界消失会让用户找不到输入框,就应使用 border.control 而不是把所有 border.divider 一起加深。最终验收应在组件的实际底色上进行,并分别覆盖 Light 与 Dark。