首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >先接一道无障碍评分,把发版前的低级问题拦在门外|数据鱼API

先接一道无障碍评分,把发版前的低级问题拦在门外|数据鱼API

原创
作者头像
用户12862874
发布于 2026-11-18 21:42:28
发布于 2026-11-18 21:42:28
90
举报
文章被收录于专栏:技术手册技术手册

上个月帮朋友复盘一个刚上线的活动页。运营转来一条客服记录:一位视障用户托人转述,页面上那三个圆角卡片到底是什么商品。开发打开页面看了半天,回了一句"图上写着呢"。问题恰恰出在这——图上的字,读屏软件读不出来,因为三张商品图全没写替代文本。这种问题功能测试提不出来,视觉验收也看不出来,只有真正依赖读屏工具的用户会一头撞上。

这件事之后我有个习惯:发版前,先让机器替用户看一遍页面。

下面拿数据鱼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 的计数——一眼就能看出这页面是"带几处小伤上线",还是"结构性的欠账"。

html 还是 url:两种送检姿势

调用只有一条 POST 的 scan 端点,参数二选一。手里有源码,传 html 参数(兼容旧调用的 content 是它的别名);只有线上地址,传 url,服务端会自己去抓取页面再检查,抓取逻辑带超时和三次重试。两个都传时,写成网址形式的那个值会被当作 URL 处理;两个都空,直接返回 400,不会塞给你一个默认分数糊弄过去。

这个二选一的设计对流水线很友好。构建产物是静态 HTML 的项目,直接把打包结果送检,问题在上线前就现形;CMS 渲染出来的页面,送线上地址更接近用户真实看到的版本。URL 抓取失败时会明确报错,而不是静默给个高分——检查工具最忌讳的,就是把"没查成"伪装成"没问题"。数据鱼这个接口在这点上做得干脆:查不了就是查不了,原因写在返回的 msg 里,调用方自己决定下一步。

把评分塞进发布流程

工具的价值取决于它出现在流程的哪一步。放在上线之后,它是客服工单的注脚;放在发布之前,它才是刹车。我的做法是三条:

  • 首页和核心转化页,每次发版各扫一遍,分数不低于上一次发布;掉了分,先修再发。
  • 活动页这类一次性页面,盯住扣分大的项,lang 和 title 属于一次修复、长期受益的,优先处理。
  • warning 别忽略,error 之外它往往是下一个版本的问题预告。
代码语言:javascript
复制
POST /api/a11y-check/scan
{"html":"<html lang=\"zh-CN\"><body><img src=\"a.png\" alt=\"本月促销商品\"></body></html>"}

无障碍这件事,最怕的不是不会做,而是默认"应该没问题"。评分把"感觉还行"变成一个可以盯住的数字,发布流程里多一道两分钟的检查,比事后处理投诉、安抚用户便宜得多。数字管不住审美,但完全管得住低级失误。

以上记分规则、参数与端点行为,整理自数据鱼API「无障碍检查」接口的公开文档;文中页面与示例均为虚构。检测结果仅供参考,最终表述请人工复核并以最新法规为准。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 评分六十的页面,问题都出在哪
  • html 还是 url:两种送检姿势
  • 把评分塞进发布流程
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档