UI 视觉设计 / 系统课时
为明暗主题建立颜色映射规则
为明暗主题建立颜色映射规则
直接将白色替换成黑色,常会让卡片层级消失、按钮文字失去对比、图表曲线难以辨认。本课以任务工作台为例,建立语义颜色的明暗映射表,并给出表面、图标、交互状态与图表的可检查规则。
学习目标
- 区分基础色、语义令牌和组件用色,建立两套主题映射。
- 为表面、文字、按钮、图标及图表定义明确的视觉角色。
- 用对比度阈值和状态清单完成明暗主题验收。
先把颜色命名为用途
设计系统分三层:基础色保存 HEX 值,语义令牌表达颜色职责,组件引用语义令牌。例如 button.primary.background 引用 action-primary,card.background 引用 surface-1,不要让组件直接绑定 blue-700 或固定的 #FFFFFF。
切换主题时只改变语义令牌对应的色值,组件引用关系保持不变。按钮的填充和文字必须成对映射:action-primary 配合 on-action-primary,否则浅色主题的白字可能被错误地留在浅色按钮上。

建立可交付的双主题色表
以下 HEX 是一套示例项目值,不是所有品牌的固定配色。页面背景使用 canvas,普通卡片使用 surface-1,卡片内部的筛选区使用 surface-2;深色模式通过表面亮度和边界共同表达层级,而不是仅靠阴影。
| 语义令牌 | 浅色 Light | 深色 Dark | 用途 |
|---|---|---|---|
canvas |
#F3F6FB |
#0B1220 |
页面画布 |
surface-1 |
#FFFFFF |
#1F3048 |
主卡片 |
surface-2 |
#E9EEF6 |
#344A64 |
卡内次级区域 |
text-primary |
#0F172A |
#F8FAFC |
标题与正文 |
text-secondary |
#475569 |
#CBD5E1 |
辅助信息 |
icon-default |
#334155 |
#CBD5E1 |
通用功能图标 |
control-outline |
#64748B |
#94A3B8 |
需要边界才能识别的输入控件 |
action-primary |
#1D4ED8 |
#93C5FD |
主按钮填充 |
on-action-primary |
#FFFFFF |
#0B1220 |
主按钮文字和图标 |
danger-text |
#B91C1C |
#FCA5A5 |
错误说明文字 |
例如浅色主按钮的白字与蓝色填充对比度约为 6.70:1;深色主按钮的深字与浅蓝填充约为 10.38:1。把这类前景/背景配对写进交付表,不允许开发只替换其中一项。
单独设计交互状态与表面边界
同一个主按钮至少检查默认、悬停、按下、键盘焦点和禁用五种状态。可把浅色悬停设为 #1E40AF、按下设为 #1E3A8A;深色悬停设为 #BFDBFE、按下设为 #60A5FA,各状态沿用对应主题的按钮前景色,并重新检测对比度。
键盘焦点使用 2px 实线外轮廓,与控件相隔 2px;浅色轮廓用 #1D4ED8,深色用 #93C5FD。对于无填充的输入框,control-outline 必须相对相邻表面足够清晰。禁用状态单独定义背景和文字色,不建议给整个组件统一降低透明度,因为叠在不同表面上会产生不可预测的结果。
让状态提示与图表不只依赖颜色
错误提示使用 danger-text,同时显示错误图标和“保存失败”文字;成功提示可用浅色 #166534、深色 #86EFAC,配合勾选图标与“已保存”。红色和绿色不能成为唯一的信息载体。
任务趋势图的三条序列可分别规定为:本周用浅蓝系 #1D4ED8/深蓝系 #93C5FD 加实线和圆点;上周用 #A16207/#FCD34D 加虚线和方点;目标用 #166534/#86EFAC 加点线和三角点。图例必须同时写名称、颜色和线型,切到灰度显示仍能匹配曲线。图表网格线属于辅助层,不能抢过数据线的视觉权重。
逐屏检查两套主题
根据 WCAG 2.2 文本对比度要求,普通文字至少 4.5:1,大号文字至少 3:1;根据 非文本对比度要求,识别控件、状态和关键图形所必需的视觉信息至少 3:1。计算时要比较元素与实际相邻颜色,不是只拿每个色值对纯白进行检测。禁用控件属于标准豁免情形,但仍应保证用户能理解其不可操作。
在 390px 与 1440px 画板各做一份相同内容的亮暗预览,按以下顺序验收:
- 检查画布、卡片、卡内区域的三层边界,尤其是深色模式中的输入框与浮层。
- 检查标题、辅助文字、图标、按钮文字和错误提示的实际前景/背景配对。
- 切换按钮五种状态,使用键盘 Tab 确认焦点轮廓可见,禁用状态不被误认成可点击。
- 用灰度或色觉模拟查看趋势图、成功/失败提示,确保标签、线型和图标仍能区分。
- 记录未通过项的令牌名、主题、组件状态与实测对比度,先修令牌,再复查所有引用组件。
最终交付物应包含双主题令牌表、按钮状态表、两种视口的对照画板和问题记录。发现一处颜色不合格时,优先检查它引用的语义令牌,而不是逐个页面手工补色。