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 画板各做一份相同内容的亮暗预览,按以下顺序验收:

  1. 检查画布、卡片、卡内区域的三层边界,尤其是深色模式中的输入框与浮层。
  2. 检查标题、辅助文字、图标、按钮文字和错误提示的实际前景/背景配对。
  3. 切换按钮五种状态,使用键盘 Tab 确认焦点轮廓可见,禁用状态不被误认成可点击。
  4. 用灰度或色觉模拟查看趋势图、成功/失败提示,确保标签、线型和图标仍能区分。
  5. 记录未通过项的令牌名、主题、组件状态与实测对比度,先修令牌,再复查所有引用组件。

最终交付物应包含双主题令牌表、按钮状态表、两种视口的对照画板和问题记录。发现一处颜色不合格时,优先检查它引用的语义令牌,而不是逐个页面手工补色。

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

目录与阅读设置

阅读设置

17

记录一个想法

为明暗主题建立颜色映射规则

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

登录哪都通