UI 视觉设计 / 系统课时

建立视觉回归与规范版本记录

建立视觉回归与规范版本记录

这节把“看起来没问题”的页面验收变成可复查的证据:为代表性页面与关键交互状态保存截图基线,在固定条件下识别视觉差异,再将批准的调整写入规范版本记录。

学习目标

  • 为桌面、平板和手机建立覆盖关键状态的截图清单。
  • 区分预期变更、动态内容噪声和意外视觉回归。
  • 制定基线更新、版本留痕与最终验收的操作规则。

选定最小但有效的截图基线

基线是已通过设计与开发共同确认的页面截图,而不是最新一次自动生成的图片。以工单后台为例,优先选择布局差异大、操作频繁或容易产生溢出的页面,不必对全部路由做完整状态排列。

页面 视口(CSS px) 固定截图状态 张数
工单列表 1440×900 默认、行操作悬停 2
工单列表 390×844 卡片列表、筛选抽屉展开 2
新建工单 1440×900 默认、字段校验错误 2
新建工单 390×844 字段校验错误 1
工单详情 768×1024 详情内容与操作区 1
仪表盘 1440×900 数据加载完成 1

首轮共 9 张。若本次修改了弹窗焦点、深色主题或空状态,再按影响范围补充截图,而不是机械地增加所有排列组合。每张截图需能识别页面、视口与状态,例如 ticket-list-mobile-filter-open.png。

固定截图环境与可复现数据

同一页面在不同字体、缩放比例或动态数据下也会产生像素差异。先统一采集条件,再讨论设计是否真的退化。

  1. 锁定浏览器及版本、操作系统字体环境、语言与时区;页面缩放设为 100%,设备像素比固定为 1。
  2. 按矩阵逐一设置视口宽高;待网络请求和 Web 字体加载完成后再截图。测试截图时关闭动画、光标闪烁与过渡效果,避免捕获到中间帧。
  3. 使用固定的工单标题、编号、时间、图表数据和头像。能替换成测试数据的字段,不要依靠大块遮罩;遮罩可能掩盖文字截断和布局偏移。
  4. 首次评审通过后,将图片归档到 baselines/v1.4.0/,保留截图环境说明、页面地址或路由、测试数据版本及截图日期。

按变更范围判定每张差异

对比时将旧基线与候选截图并排查看,必要时使用半透明叠加或差异高亮。可暂定“差异像素占比超过 0.3% 则优先人工检查”为分诊规则,但低于门槛也不能自动放行:一个 16px 的按钮溢出可能只占很小面积。

差异类型 工单后台实例 处理动作
预期调整 变更单规定主按钮高度从 40px 改为 44px 核对受影响页面,批准后更新对应基线
数据噪声 时间戳、随机头像或图表数据不同 固定测试数据并重新截图
意外回归 手机端提交按钮超出容器右侧 16px 修复布局、重新截图,旧基线暂不变

视觉回归差异分类与基线审批流程

不能因为候选图与基线不一致,就直接批量接受新截图。应先逐项回答:变化是否写在变更单中、是否影响未修改的页面、是否引发裁切、换行、对齐或焦点可见性问题。

为规范版本记录写清证据链

版本号本身无法解释为什么发生变化。每条记录至少要包含变更编号、修改前后数值、影响组件和页面、截图位置、评审人及处理结果。以下是一条可直接参考的记录:

字段 示例
规范版本与变更编号 v1.4.1 / UI-042
修改内容 主按钮高 40→44 CSS px;左右内边距 12→16 CSS px
影响范围 工单列表与新建工单的桌面、手机视图
对比证据 baselines/v1.4.0/ 与 reviews/UI-042/
初审结果 9 张中预期变化 3 张、意外溢出 1 张、无变化 5 张
最终处理 修复手机端 16px 溢出,重拍复核;设计与前端共同批准

v1.4.1 是本项目自定的规范版本,不代表工具自动生成的版本。只有在变更范围和截图经确认后,才发布新版本,并且只更新实际发生批准变更的基线;旧版本需归档以便追溯。

用可核对的条件完成验收

交付时将规范版本、截图矩阵、旧基线、候选截图及差异记录放在同一个可追溯的交付目录中。验收可以采用以下明确门槛:

  1. 覆盖完整:矩阵中 9 张截图全部采集并完成评审;新增状态另列,不用旧截图冒充。
  2. 异常清零:意外差异已修复并重拍,未解释差异为 0;检查 390px 手机视口无意外横向滚动,重要文字、按钮和焦点轮廓没有被裁切。
  3. 变更可追溯:每项被批准的差异均能对应变更编号、修改前后取值、截图文件和评审结论。
  4. 基线受控:仅在设计、开发负责人确认后更新正式基线;未通过的候选截图留在评审目录,不覆盖历史证据。

这样下一次改动按钮、表格或响应式断点时,团队能直接知道应重新检查哪几张图,以及哪些变化已经获得批准。

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

目录与阅读设置

阅读设置

17

记录一个想法

建立视觉回归与规范版本记录

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

登录哪都通