UI 视觉设计 / 系统课时
排版规则变更后如何进行回归验收
排版规则变更后如何进行回归验收
修改字号、行高或字重令牌后,页面可能没有报错,却出现按钮变高、表单错位或表格列宽变化。本课用组件验收矩阵、计算样式断言和视觉快照建立回归流程,区分真实缺陷与经过批准的设计调整。
学习目标
- 为标题、正文、按钮、表单和表格制定可核对的验收项。
- 用自动化断言发现令牌失效、局部覆写及尺寸变化。
- 按统一标准处理视觉差异并决定是否更新基线。
固定组件和视口验收矩阵
先记录变更前的设计规范,再验收页面。以下数值是示例项目的基准,并非所有产品都应采用的通用字号。
| 对象 | 示例基准 | 重点检查 |
|---|---|---|
| 标题 | 24px / 行高32px / 字重600 | 换行位置、下方间距 |
| 正文 | 16px / 行高24px / 字重400 | 段落高度、长文本换行 |
| 按钮 | 14px / 行高20px / 最小高度44px | 文本居中、点击区域 |
| 表单 | 标签14px / 行高20px | 标签、输入框、错误提示不重叠 |
| 表格 | 数字16px / 行高24px | 右对齐、列宽、行高 |
至少检查桌面端 1280×800 和窄屏 390×844;另在浏览器手动放大到 200%,确认文本不被固定高度容器裁切。验收截图应固定字体文件、浏览器版本、系统与视口;否则渲染环境差异会制造噪声。
从令牌变更追踪到组件差异
每次更改都记录令牌名、旧值、新值与影响范围。例如把 --font-body 从 16px 改成 18px,不仅要看正文,还要检查引用该令牌的表格单元格;未随之变化的组件可能存在局部覆写。

建议每次变更保留变更前后同视口截图,并把基线与对应代码提交绑定;不要在发现快照失败后直接批量更新。
用 Playwright 验证样式和视觉快照
在空目录创建 typography.spec.js。下面的完整测试自带简化页面,能直接演示五类组件的计算样式检查;接入真实项目时,再把 page.setContent 改成访问实际页面。
const { test, expect } = require('@playwright/test');
const html = `
<style>
:root { --font-title: 24px; --font-body: 16px; }
body { font-family: Arial, sans-serif; margin: 24px; }
h1 { font-size: var(--font-title); line-height: 32px; font-weight: 600; }
p, td { font-size: var(--font-body); line-height: 24px; }
button, label { font-size: 14px; line-height: 20px; }
button { min-height: 44px; }
td { text-align: right; font-variant-numeric: tabular-nums; }
</style>
<h1>订单总览</h1><p>请确认本月数据</p>
<button>提交</button>
<form><label for="name">姓名</label><input id="name"></form>
<table><tr><td>1234.50</td></tr></table>`;
for (const width of [1280, 390]) {
test(`排版回归 ${width}px`, async ({ page }) => {
await page.setViewportSize({ width, height: width === 1280 ? 800 : 844 });
await page.setContent(html);
const specs = {
h1: ['24px', '32px'], p: ['16px', '24px'],
button: ['14px', '20px'], label: ['14px', '20px'],
td: ['16px', '24px']
};
// 检查最终计算样式,局部覆写也会触发失败。
for (const [selector, expected] of Object.entries(specs)) {
const actual = await page.locator(selector).evaluate(el => {
const s = getComputedStyle(el);
return [s.fontSize, s.lineHeight];
});
expect(actual).toEqual(expected);
}
const buttonHeight = await page.locator('button')
.evaluate(el => el.getBoundingClientRect().height);
expect(buttonHeight).toBeGreaterThanOrEqual(44);
// 同时守住整页宽度与同环境截图基线。
const overflow = await page.evaluate(
() => document.documentElement.scrollWidth > innerWidth
);
expect(overflow).toBe(false);
await expect(page).toHaveScreenshot(`typography-${width}.png`, {
animations: 'disabled', maxDiffPixelRatio: 0.005
});
});
}安装依赖并首次建立快照,再执行普通回归:
npm init -y
npm install --save-dev @playwright/test
npx playwright install chromium
npx playwright test typography.spec.js --update-snapshots
npx playwright test typography.spec.js预期结果(末次命令输出节选):
2 passed (<TIME>)<TIME> 是随机器变化的运行耗时。首次生成的快照应经过人工确认并提交版本管理;随后修改 --font-body 为 18px 而不调整断言时,正文和表格的样式检查会失败。maxDiffPixelRatio: 0.005 表示整张截图允许最多约 0.5% 像素不同,不能代替尺寸与可读性检查。
判定差异和放行
按“样式值、布局边界、视觉差异”的顺序定位失败:计算样式不符,先查令牌引用和选择器优先级;样式值正确但元素溢出,再查固定高度、内边距与容器宽度;仅快照不一致,检查字体文件、浏览器版本及抗锯齿环境是否变化。
- 必须修复:按钮高度低于44px、错误提示遮住输入框、文字在200%缩放下被裁切,或未经批准的字号变化。
- 允许更新基线:设计已确认的新字号和换行效果,且两个视口、表单错误态及长文本均通过复核。
- 放行证据:变更令牌清单、两套视口快照、自动测试结果、人工确认记录和基线更新提交。
回归通过意味着本次被覆盖的组件和状态满足约定标准;尚未测试的页面或特殊语言不应被标记为已验收。