Alignment 是一个检查运行中页面是否对齐、是否平衡的技能。它测量渲染后的实际墨迹,在放大截图中确认每一项发现,并返回带编号的报告。
用途
该技能用于发现页面中“差一两个像素”的对齐问题。它强调:线条、间距、居中和圆角一律测量,绝不估算。1–4 像素的偏差会被视为问题,因为它读起来像失误;而 16 像素的缩进则读起来像有意为之。视觉重量没有数字,因此从截图中判断并以裁剪图展示。
技能边界明确:打开运行结果属于 verify;与指定参考对比属于 match;强制 hover、open 和 error 状态属于 lab;把修复移入共享组件属于 reuse;渲染每个宽度属于 viewports。
主要能力
技能覆盖以下检查规则:
- alignment-measure-the-render:在运行页面中以 2x 设备缩放因子测量,而非从 CSS 推断元素应落在哪里。
- alignment-shared-edge:同一列起始的文本、图标和控件应共享一个 x 坐标。标题比其描述右偏 2px 即属此类。
- alignment-even-gaps:重复的兄弟元素应保持同一间距。列表间距为 8、8 然后 12px 即属此类;有意的分组间隔至少是间距的两倍。
- alignment-on-scale:每个 padding、gap 和 margin 都应是项目刻度上的一步。4px 刻度上出现 6px padding 即属此类。
- alignment-ink-centre:控件中的文本应以其大写高度和基线居中,而非行盒。按钮中墨迹偏低 2px 即属此类,可用 text-box: trim-both cap alphabetic 或平衡 padding 修正。
- alignment-icon-with-label:标签旁的图标应以标签的大写高度居中。图标按行盒居中而偏低 1px 即属此类。
- alignment-optical-glyph:播放图标、箭头和三角形重量偏于一侧。按盒居中的播放图标看起来偏左即属此类,可微调并命名数值,如 --play-nudge: 1px。
- alignment-concentric-radius:嵌套表面的圆角等于外圆角减去内缩。16px 卡片内缩 8px 的 16px 面板应取 8px。
- alignment-visual-weight:圆形和三角形需要比方形大约 10% 才能读作等大;2px 图标描边与 1.5px 文本主干并置即属此类。
- alignment-annotated-proof:发现必须带测量值和矩形,而非“按钮看起来有点偏”。
- alignment-shipped-report:报告应复制 report.html 并只写 report.js,而非手工裁剪、从零编写页面。
使用方式
- 打开交付的渲染:在页面交付时的视口打开,设备缩放因子为 2,检查用户指定的每个主题和状态。
- 运行测量:先从项目 token 读取间距刻度,通过浏览器 evaluate 调用在页面中运行 measure.js,传入 window.__alignmentOptions = { scale }。返回的发现包含规则、元素、测量值和矩形,在步骤 3 确认前均视为候选。
- 检查线条:从 2x 截图中裁剪每个候选并数像素,丢弃像素未显示的发现。
- 检查居中:核对文本墨迹居中、图标与标签居中、光学字形和同心圆角。
- 判断重量:在 1x 截图上看眼睛首先落在哪里,比较图标描边与文本主干重量、填充图标与轮廓图标、同尺寸绘制的圆与方。
- 带证据报告:将 report.html 复制到 .alignment/<page>/index.html(被忽略的文件夹,绝不写入源码树),在旁边保存 2x 截图,按 report.js 头部注释所示的形状编写并打开。报告绘制编号轮廓并从该截图裁剪放大图,因此只写数据。
- 仅在要求时修复:报告即交付物。用户要求修复时,改动每个发现背后的 token 或 primitive,重新运行脚本和截图,然后报告哪些已清除。
报告格式
严重程度:HIGH 是在 1x 下主表面(如标题列或主按钮)上可见的偏差;MEDIUM 是 1–2px 偏差、不均匀间距、圆角不匹配、重量失衡或手工构建的报告;LOW 是仍渲染对齐但偏离刻度的值。
格式为每个根因一条发现,编号与叠加层对应:
- file:line - [rule-id] 哪里错了(测量值)
当找不到源码行时,引用脚本中的元素。随后是 Rule | Count | Severity 摘要。存在任何 HIGH 时 Block,否则 Approve。canvas、image 和跨域内容标记为 Not verified。
适用场景与限制
适用于需要像素级对齐审查的运行中页面,尤其是主表面、标题列、按钮、列表和嵌套面板。限制:视觉重量依赖人工判断;canvas、image 和跨域内容无法验证;技能本身只产出报告,不主动修复;修复需用户明确要求。