上个月帮朋友复盘一个刚上线的活动页。运营转来一条客服记录:一位视障用户托人转述,页面上那三个圆角卡片到底是什么商品。开发打开页面看了半天,回了一句"图上写着呢"。问题恰恰出在这——图上的字,读屏软件读不出来,因为三张商品图全没写替代文本。这种问题功能测试提不出来,视觉验收也看不出来,只有真正依赖读屏工具的用户会一头撞上。
这件事之后我有个习惯:发版前,先让机器替用户看一遍页面。
下面拿数据鱼API的「无障碍检查」服务当例子。它对一个页面或一段 HTML 做基础无障碍扫描,直接给出 0 到 100 的评分和问题清单,正好用来聊聊怎么把这类检查变成发布前的日常动作。
先看记分规则。评分从 100 起步,每发现一个问题按 impact 扣分,扣完为止。文档里有条实测记录很有代表性:一个只有一张图、没写语言声明、没写标题的极简页面,得了 60 分——缺 lang 属性扣 20,缺 title 扣 15,图片缺 alt 扣 5。
问题 | 扣分 | 修复动作 |
|---|---|---|
html 标签缺 lang 属性 | 20 | 补上 zh-CN 这类语言声明 |
缺失或空的 title 标签 | 15 | 写一个能概括页面的标题 |
图片缺 alt 属性 | 5 | 给每张图写替代文本 |
注意这三条的共同点:没有一条是"高级难题",全是发布前顺手就能补的功课。无障碍工作常被想象成"要养一个专门团队"的大工程,可真正拉低分数的,往往是这些五分钟能修完的细节。数据鱼API的这个接口在响应里同时给 issues 数组和 summary 汇总,前者是问题明细,带类型、描述和扣分;后者是 error 与 warning 的计数——一眼就能看出这页面是"带几处小伤上线",还是"结构性的欠账"。
调用只有一条 POST 的 scan 端点,参数二选一。手里有源码,传 html 参数(兼容旧调用的 content 是它的别名);只有线上地址,传 url,服务端会自己去抓取页面再检查,抓取逻辑带超时和三次重试。两个都传时,写成网址形式的那个值会被当作 URL 处理;两个都空,直接返回 400,不会塞给你一个默认分数糊弄过去。
这个二选一的设计对流水线很友好。构建产物是静态 HTML 的项目,直接把打包结果送检,问题在上线前就现形;CMS 渲染出来的页面,送线上地址更接近用户真实看到的版本。URL 抓取失败时会明确报错,而不是静默给个高分——检查工具最忌讳的,就是把"没查成"伪装成"没问题"。数据鱼这个接口在这点上做得干脆:查不了就是查不了,原因写在返回的 msg 里,调用方自己决定下一步。
工具的价值取决于它出现在流程的哪一步。放在上线之后,它是客服工单的注脚;放在发布之前,它才是刹车。我的做法是三条:
POST /api/a11y-check/scan
{"html":"<html lang=\"zh-CN\"><body><img src=\"a.png\" alt=\"本月促销商品\"></body></html>"}无障碍这件事,最怕的不是不会做,而是默认"应该没问题"。评分把"感觉还行"变成一个可以盯住的数字,发布流程里多一道两分钟的检查,比事后处理投诉、安抚用户便宜得多。数字管不住审美,但完全管得住低级失误。
以上记分规则、参数与端点行为,整理自数据鱼API「无障碍检查」接口的公开文档;文中页面与示例均为虚构。检测结果仅供参考,最终表述请人工复核并以最新法规为准。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。