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 改成访问实际页面。

js
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
    });
  });
}

安装依赖并首次建立快照,再执行普通回归:

bash
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

预期结果(末次命令输出节选):

text
2 passed (<TIME>)

<TIME> 是随机器变化的运行耗时。首次生成的快照应经过人工确认并提交版本管理;随后修改 --font-body 为 18px 而不调整断言时,正文和表格的样式检查会失败。maxDiffPixelRatio: 0.005 表示整张截图允许最多约 0.5% 像素不同,不能代替尺寸与可读性检查。

判定差异和放行

按“样式值、布局边界、视觉差异”的顺序定位失败:计算样式不符,先查令牌引用和选择器优先级;样式值正确但元素溢出,再查固定高度、内边距与容器宽度;仅快照不一致,检查字体文件、浏览器版本及抗锯齿环境是否变化。

  • 必须修复:按钮高度低于44px、错误提示遮住输入框、文字在200%缩放下被裁切,或未经批准的字号变化。
  • 允许更新基线:设计已确认的新字号和换行效果,且两个视口、表单错误态及长文本均通过复核。
  • 放行证据:变更令牌清单、两套视口快照、自动测试结果、人工确认记录和基线更新提交。

回归通过意味着本次被覆盖的组件和状态满足约定标准;尚未测试的页面或特殊语言不应被标记为已验收。

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

目录与阅读设置

阅读设置

17

记录一个想法

排版规则变更后如何进行回归验收

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

登录哪都通