ACR 中每一行的最后一栏是“Remarks and Explanations”(备注和说明)。符合等级告诉采购方你在多大程度上满足了该标准;备注则告诉他们哪里不足、影响谁、如何绕过。两份都写着 Partially Supports(部分支持)的报告,备注写得清楚的那份更容易通过审查。
好的备注包含四点
- 位置:哪个页面、模块或组件。
- 问题:具体是哪种行为不满足标准,而不是“存在一些问题”。
- 程度:有多少满足标准,有多少不满足。
- 替代方式:如果有等效的方法完成同一任务,要写出来。
备注通常用英文写,因为大多数采购方阅读的是英文 ACR。用现在时的短句陈述事实,不要用营销语言。
八个示例
这些示例只用于展示写法。请把内容换成你自己产品的实际测试结果。
1.1.1 Non-text Content · Partially Supports
Most images have text alternatives. Charts on the Reports dashboard do not have a text alternative; the same data is available in the table below each chart.
写明了位置(Reports 仪表盘)、问题(图表没有文本替代)和替代方式(下方的表格)。
1.4.3 Contrast (Minimum) · Partially Supports
Body text and controls meet the 4.5:1 ratio. Placeholder text in form fields and the timestamp text in the activity feed do not.
先说哪些满足标准,再点名不满足的具体元素。
2.1.1 Keyboard · Partially Supports
All functions can be operated with a keyboard except reordering cards by drag and drop in Board view. List view offers the same reordering with keyboard support.
拖放是常见的键盘问题,所以写清等效的键盘操作路径很重要。
2.4.7 Focus Visible · Supports
All interactive elements show a visible focus indicator.
Supports 的备注可以很短,但最好不要留空。
1.2.2 Captions (Prerecorded) · Not Applicable
The product does not contain prerecorded video with audio.
只有确实没有视频时才能这样写。如果帮助中心的教程视频在报告范围内,就不是 Not Applicable(不适用)。
2.5.8 Target Size (Minimum) · Partially Supports
Icon buttons in the table toolbar are 20 by 20 CSS pixels and are placed without enough spacing. Other targets meet the requirement.
WCAG 2.2 新增的标准:目标至少为 24×24 CSS 像素,或者周围留有足够的间距。
3.3.8 Accessible Authentication (Minimum) · Does Not Support
The sign-in form blocks pasting into the password field, so password managers cannot fill it. No alternative sign-in method is offered.
密码框禁止粘贴,是 3.3.8 不通过的常见原因之一。
4.1.2 Name, Role, Value · Partially Supports
Standard controls expose names and roles. The custom date picker and the toggle switches in Settings do not expose their state to assistive technology.
4.1.2 的问题大多出在自定义组件上。点名具体组件,比含糊地说“部分组件”更有用。
应避免的措辞
- “Fully compliant”或“100% accessible”。这种绝对的说法任何测试都无法支撑,而且很容易与其他行的等级相矛盾。
- “Some issues may exist.”太含糊,采购方无法判断影响。
- 带具体日期的修复承诺。“Will be fixed by Q2”一旦延期,就会成为下一次审查中的问题。写“A fix is planned”,把日期放在单独的路线图里。
- 每一行都重复测试方法。测试工具和方法属于报告顶部的“Evaluation Methods Used”(评估方法)一节。每条备注只写该行的结论。
- 照搬其他产品的备注。采购方会把备注和实际界面对照。备注里提到你的产品根本没有的功能,会立刻损害你的可信度。
备注和等级必须一致
如果备注描述了问题,等级就不能是 Supports。如果等级是 Partially Supports,备注就必须说明哪部分不满足。如何选择等级,参见VPAT 符合等级怎么选。
下一步
从生成器下载的 .docx 中,每条标准都附有一条根据等级生成的占位备注。请按上面的结构,把每条都换成你产品的实际测试结果。