UI 视觉设计 / 系统课时

建立色彩回归与变更检查表

建立色彩回归与变更检查表

页面配色完成后,仍可能存在语义颜色引用错误、文字对比度不足、交互状态遗漏和主题切换异常。本课以订单工作台为例,建立一份包含检查项目、量化标准、覆盖范围、变更追踪和签收条件的色彩验收表,让每次颜色调整都有明确的检查依据和回归结果。

学习目标

  • 建立覆盖颜色命名、对比度、组件状态和多主题切换的验收清单。
  • 使用具体阈值、测试矩阵和证据记录判断页面是否通过验收。
  • 根据颜色 Token 的引用关系确定变更影响范围,并完成缺陷复验与交付签收。

确定验收范围与基线

色彩回归需要先固定比较对象。否则,设计稿和前端实现可能使用不同版本的 Token,导致同一颜色问题反复出现。

以支持两个品牌、浅色和深色主题的订单工作台为例,选择三个代表性页面:订单列表、订单详情、订单编辑表单。每个页面分别检查桌面端 1440px 和移动端 390px 宽度。

基础页面组合数量为:2 个品牌 × 2 种主题 × 3 个页面 × 2 种视口 = 24 组页面基线。这 24 组用于验证页面整体颜色层级,组件交互状态另外逐项检查。

每次开始验收前固定以下信息:

  1. 记录 Figma 中已批准的颜色变量版本和前端组件库版本。
  2. 保存 24 组页面的基线截图,统一使用相同的页面数据与视口宽度。
  3. 建立验收记录字段:品牌、主题、页面、视口、组件、状态、检查项、结果、证据、负责人。
  4. 结果限定为通过、失败、不适用、未测试四种;不适用必须填写原因,未测试不能计入通过率。

例如,截图可以命名为 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 组基础页面截图不能替代交互状态测试。悬停、按下、选中、禁用和键盘焦点通常不会同时出现在静态设计稿中,需要另外建立组件状态矩阵。

测试对象 必测状态 验收重点
筛选按钮 默认、悬停、按下、选中、禁用、焦点 状态变化可辨认,焦点指示清楚
订单状态标签 待处理、已完成、警告、失败 文字和图标能辅助识别状态
表单输入框 默认、焦点、错误、禁用 边框、提示文字及错误标识可辨认
弹窗与遮罩 关闭、打开、叠加浮层 弹窗与背景形成清晰层级,正文仍可阅读

每种品牌与明暗主题组合都应执行上述状态测试。如果实际产品还有加载、空状态、成功提示或高亮提醒,应补充对应记录,不要将未覆盖状态直接标记为通过。

主题切换至少执行以下操作:

  1. 将设置改为 light,检查页面及弹窗均使用浅色语义变量。
  2. 改为 dark,检查文字、图标、边框和反馈状态是否正确映射。
  3. 改为 system,分别模拟操作系统浅色与深色偏好,验证页面跟随变化。
  4. 手动指定 dark 后再改变系统偏好,确认显式选择不会被系统设置覆盖。
  5. 刷新页面,确认用户选择按产品约定保留;再切换品牌,确认信息色的语义没有改变。

对于设计系统中的“已完成”,品牌 A 可以使用绿色状态色,品牌 B 可以使用另一组符合品牌规范的绿色色阶,但都必须表达相同的成功语义,并保留相同的文字或图标提示。

根据 Token 引用关系安排变更回归

颜色调整不能只复查提出问题的那个组件。一个语义 Token 可能同时被订单卡片、筛选区、弹窗和移动端表单使用;修改基础色时,还可能影响多个语义别名。

假设发现浅色主题中次级文字对比度不足,决定将 color.text.secondary 对应的浅色值从 #94A3B8 改为 #64748B。

先填写一条变更记录:

字段 示例记录
变更对象 color.text.secondary
修改范围 品牌 A 的浅色主题
修改前后 #94A3B8 → #64748B
修改原因 白底普通文字对比度低于 4.5:1
直接引用组件 订单卡片、筛选计数、弹窗帮助文字
回归页面 订单列表、订单详情、订单编辑表单
验证结果 白底示例对比度约 2.56:1 → 4.76:1;其他背景需要分别实测

具体回归按以下顺序执行:

  1. 查找被修改 Token 的全部直接引用位置。如果修改的是基础色,还需查找引用它的语义别名,再继续追踪使用这些别名的组件。
  2. 在受影响页面和组件状态中复测文字对比度,尤其检查次级卡片背景、选中背景和弹窗表面是否仍然合格。
  3. 对照修改前后的相同视口截图,检查文字层级是否变得过重,以及相邻元素的视觉优先级是否发生意外变化。
  4. 检查其他品牌与深色主题是否意外受到影响。即使它们使用独立映射,也要确认没有共享基础色或错误别名导致连带变化。
  5. 在变更记录中填写实际覆盖范围、测试结果和截图证据,不能只记录最初发现问题的位置。

关闭缺陷并完成交付签收

回归检查的最后一步是把失败项目变成可追踪的修复记录,并明确什么条件下允许版本交付。

每条失败记录至少包含:复现条件、期望结果、实际结果、相关 Token、受影响页面、严重程度、负责人和复验状态。

例如,可以记录“品牌 A、浅色主题、390px、订单详情页、次级说明文字:实测 2.56:1,要求至少 4.5:1”,并附上测量结果和页面截图。修复后必须重新测量,同时复查该 Token 所有已识别的引用位置。

建议采用以下签收条件:

  • 24 组基础页面全部完成核对,必测组件状态和主题切换测试完成率为 100%。
  • 适用的 AA 对比度检查全部通过;例外项目记录对应标准依据与不适用原因。
  • 没有未解决的阻断级或严重级色彩问题;其他问题有明确处置决定和负责人。
  • 每一项已修复缺陷都有复验记录,每一次 Token 修改都有影响范围和变更前后证据。
  • 最终交付记录包含颜色 Token 版本、组件库版本、验收日期、检查人员和批准人员。

交付前可进行一次反向抽查:任选一个最近修改的 Token,能否从变更记录找到引用组件、覆盖页面、主题组合、测试结果和截图。如果其中任一环节缺失,应补齐证据后再签收。这样下一次迭代可以直接依据本次基线检查变化,而不必重新猜测每个颜色的设计意图。

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

目录与阅读设置

阅读设置

17

记录一个想法

建立色彩回归与变更检查表

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

登录哪都通