UI 视觉设计 / 系统课时
建立色彩回归与变更检查表
建立色彩回归与变更检查表
页面配色完成后,仍可能存在语义颜色引用错误、文字对比度不足、交互状态遗漏和主题切换异常。本课以订单工作台为例,建立一份包含检查项目、量化标准、覆盖范围、变更追踪和签收条件的色彩验收表,让每次颜色调整都有明确的检查依据和回归结果。
学习目标
- 建立覆盖颜色命名、对比度、组件状态和多主题切换的验收清单。
- 使用具体阈值、测试矩阵和证据记录判断页面是否通过验收。
- 根据颜色 Token 的引用关系确定变更影响范围,并完成缺陷复验与交付签收。
确定验收范围与基线
色彩回归需要先固定比较对象。否则,设计稿和前端实现可能使用不同版本的 Token,导致同一颜色问题反复出现。
以支持两个品牌、浅色和深色主题的订单工作台为例,选择三个代表性页面:订单列表、订单详情、订单编辑表单。每个页面分别检查桌面端 1440px 和移动端 390px 宽度。
基础页面组合数量为:2 个品牌 × 2 种主题 × 3 个页面 × 2 种视口 = 24 组页面基线。这 24 组用于验证页面整体颜色层级,组件交互状态另外逐项检查。
每次开始验收前固定以下信息:
- 记录 Figma 中已批准的颜色变量版本和前端组件库版本。
- 保存 24 组页面的基线截图,统一使用相同的页面数据与视口宽度。
- 建立验收记录字段:品牌、主题、页面、视口、组件、状态、检查项、结果、证据、负责人。
- 结果限定为通过、失败、不适用、未测试四种;不适用必须填写原因,未测试不能计入通过率。
例如,截图可以命名为 brand-a-dark-390-order-list.png,避免不同品牌和主题的证据相互覆盖。
建立可执行的颜色质量检查表
检查表中的每一项都需要同时具备执行动作和通过标准。不能只填写“颜色正确”或“符合设计稿”,因为这些描述无法独立复验。
以下以 WCAG 2.2 AA 的相关对比度要求作为可访问性验收基准。
| 检查项 | 执行方法 | 通过标准 |
|---|---|---|
| Token 命名 | 检查基础色、语义色与组件引用 | 命名符合约定,组件优先引用语义 Token,无未经批准的硬编码色值 |
| 正文对比度 | 测量文字与实际背景的对比度 | 普通文字不低于 4.5:1 |
| 大字对比度 | 检查大标题和较大加粗文字 | 符合大字定义的文字不低于 3:1 |
| 控件边界 | 检查输入框、关键图标和必要的状态标识 | 适用非文本对比度要求的视觉信息与相邻颜色不低于 3:1 |
| 状态信息 | 检查成功、警告、错误与选中状态 | 不只通过颜色传达信息,提供文字、图标或形状线索 |
| 主题映射 | 对照同一组件的浅色、深色和品牌版本 | 语义职责一致,每个主题单独满足对比度要求 |
| 组件硬编码 | 检查组件样式中的固定色值及其用途 | 应使用 Token 的颜色已完成替换,例外有明确记录 |
| 颜色层级 | 对照页面、卡片、弹窗、遮罩和文字 | 主次层级可区分,没有因主题切换丢失边界或重点信息 |
WCAG 中的大字通常指至少 18pt 的文字,或至少 14pt 的加粗文字。禁用组件等存在适用例外,不应简单要求所有灰色元素达到相同阈值;但必要的操作状态仍应能够辨认。
对比度不能只凭肉眼判断。例如,在白色背景 #FFFFFF 上使用 #94A3B8 作为普通次级文字,对比度约为 2.56:1,不满足 4.5:1。改为 #64748B 后约为 4.76:1,可以通过普通文字的 AA 对比度检查。
实际检查时应记录前景色、背景色、测量比值和判定结果。对于半透明颜色,必须基于最终合成后的显示颜色测量,而不是直接测量透明色的原始 RGB 值。
覆盖组件状态与主题切换
24 组基础页面截图不能替代交互状态测试。悬停、按下、选中、禁用和键盘焦点通常不会同时出现在静态设计稿中,需要另外建立组件状态矩阵。
| 测试对象 | 必测状态 | 验收重点 |
|---|---|---|
| 筛选按钮 | 默认、悬停、按下、选中、禁用、焦点 | 状态变化可辨认,焦点指示清楚 |
| 订单状态标签 | 待处理、已完成、警告、失败 | 文字和图标能辅助识别状态 |
| 表单输入框 | 默认、焦点、错误、禁用 | 边框、提示文字及错误标识可辨认 |
| 弹窗与遮罩 | 关闭、打开、叠加浮层 | 弹窗与背景形成清晰层级,正文仍可阅读 |
每种品牌与明暗主题组合都应执行上述状态测试。如果实际产品还有加载、空状态、成功提示或高亮提醒,应补充对应记录,不要将未覆盖状态直接标记为通过。
主题切换至少执行以下操作:
- 将设置改为
light,检查页面及弹窗均使用浅色语义变量。 - 改为
dark,检查文字、图标、边框和反馈状态是否正确映射。 - 改为
system,分别模拟操作系统浅色与深色偏好,验证页面跟随变化。 - 手动指定
dark后再改变系统偏好,确认显式选择不会被系统设置覆盖。 - 刷新页面,确认用户选择按产品约定保留;再切换品牌,确认信息色的语义没有改变。
对于设计系统中的“已完成”,品牌 A 可以使用绿色状态色,品牌 B 可以使用另一组符合品牌规范的绿色色阶,但都必须表达相同的成功语义,并保留相同的文字或图标提示。
根据 Token 引用关系安排变更回归
颜色调整不能只复查提出问题的那个组件。一个语义 Token 可能同时被订单卡片、筛选区、弹窗和移动端表单使用;修改基础色时,还可能影响多个语义别名。
假设发现浅色主题中次级文字对比度不足,决定将 color.text.secondary 对应的浅色值从 #94A3B8 改为 #64748B。
先填写一条变更记录:
| 字段 | 示例记录 |
|---|---|
| 变更对象 | color.text.secondary |
| 修改范围 | 品牌 A 的浅色主题 |
| 修改前后 | #94A3B8 → #64748B |
| 修改原因 | 白底普通文字对比度低于 4.5:1 |
| 直接引用组件 | 订单卡片、筛选计数、弹窗帮助文字 |
| 回归页面 | 订单列表、订单详情、订单编辑表单 |
| 验证结果 | 白底示例对比度约 2.56:1 → 4.76:1;其他背景需要分别实测 |
具体回归按以下顺序执行:
- 查找被修改 Token 的全部直接引用位置。如果修改的是基础色,还需查找引用它的语义别名,再继续追踪使用这些别名的组件。
- 在受影响页面和组件状态中复测文字对比度,尤其检查次级卡片背景、选中背景和弹窗表面是否仍然合格。
- 对照修改前后的相同视口截图,检查文字层级是否变得过重,以及相邻元素的视觉优先级是否发生意外变化。
- 检查其他品牌与深色主题是否意外受到影响。即使它们使用独立映射,也要确认没有共享基础色或错误别名导致连带变化。
- 在变更记录中填写实际覆盖范围、测试结果和截图证据,不能只记录最初发现问题的位置。
关闭缺陷并完成交付签收
回归检查的最后一步是把失败项目变成可追踪的修复记录,并明确什么条件下允许版本交付。
每条失败记录至少包含:复现条件、期望结果、实际结果、相关 Token、受影响页面、严重程度、负责人和复验状态。
例如,可以记录“品牌 A、浅色主题、390px、订单详情页、次级说明文字:实测 2.56:1,要求至少 4.5:1”,并附上测量结果和页面截图。修复后必须重新测量,同时复查该 Token 所有已识别的引用位置。
建议采用以下签收条件:
- 24 组基础页面全部完成核对,必测组件状态和主题切换测试完成率为 100%。
- 适用的 AA 对比度检查全部通过;例外项目记录对应标准依据与不适用原因。
- 没有未解决的阻断级或严重级色彩问题;其他问题有明确处置决定和负责人。
- 每一项已修复缺陷都有复验记录,每一次 Token 修改都有影响范围和变更前后证据。
- 最终交付记录包含颜色 Token 版本、组件库版本、验收日期、检查人员和批准人员。
交付前可进行一次反向抽查:任选一个最近修改的 Token,能否从变更记录找到引用组件、覆盖页面、主题组合、测试结果和截图。如果其中任一环节缺失,应补齐证据后再签收。这样下一次迭代可以直接依据本次基线检查变化,而不必重新猜测每个颜色的设计意图。