结论先行:Web 无障碍(a11y)不是上线前补一遍 alt 就完事,而是一份贯穿开发全程的清单:语义化 HTML 打底、键盘全程可操作、读屏能听懂、对比度达标、动效可关闭。八成的无障碍问题来自「用 div 加点击事件冒充按钮」这类语义缺失,改用语义标签就能修复。投入产出比最高的顺序是:先语义化,再键盘导航,再读屏适配,最后视觉与动效。无障碍做得好的站点,SEO、自动化测试定位、整体代码质量通常也更好,这是一笔划算的工程投资。
一、语义化:最便宜也最有效的无障碍
读屏软件依赖 HTML 语义向用户播报页面结构。button 会被读成「按钮」并支持回车与空格触发,div 加 onclick 则什么都不是,键盘用户根本摸不到它。清单第一条:可点击的元素必须是 button 或 a,导航用 nav,主内容用 main,侧栏用 aside,标题层级从 h1 到 h6 顺序递进不跳级。
表格要有 th 与 scope,列表用 ul/ol,表单控件必须绑定 label。图片分两类处理:信息性图片写准确的 alt,装饰性图片写空 alt 让读屏跳过。一个常见错误是把 alt 写成文件名或「图片」,这比不写更干扰读屏用户。landmark 区域齐全后,读屏用户可以按区域跳转,长页面的浏览效率会大幅提升。
二、键盘导航:不碰鼠标走完全站
验收方法很朴素:拔掉鼠标,只用 Tab、Shift+Tab、回车、空格、方向键与 Esc,把核心流程走一遍。检查四件事:焦点顺序是否与视觉顺序一致;焦点是否始终可见(不要全局 outline: none,要改就改成高对比的自定义焦点环);弹窗打开时焦点是否进入弹窗、关闭后是否归还触发元素;是否存在键盘陷阱(焦点进去出不来)。
两个高频修复:页面顶部加「跳到主内容」链接,让键盘用户跳过冗长导航;自定义组件(下拉、标签页、菜单)按 WAI-ARIA Authoring Practices 的模式实现方向键导航与焦点管理,而不是只处理 Tab。tabindex 只允许两种用法:0 让元素可聚焦,-1 让元素可编程聚焦;正数 tabindex 会打乱全局顺序,一律禁用。
三、ARIA:补语义,而不是造语义
ARIA 的第一规则是「能用原生 HTML 就不用 ARIA」。原生 button 自带角色、状态与键盘行为,role='button' 的 div 则需要你手动补 tabindex、键盘事件与状态,费力且容易漏。ARIA 的正确使用场景是原生语义覆盖不到的复合组件:aria-expanded 标记展开状态,aria-controls 关联被控区域,aria-live 播报异步更新,aria-modal 标记模态。
动态内容是重灾区:购物车数量变化、表单提交结果、加载完成提示,视觉用户看得到,读屏用户听不到。给状态区域加 aria-live='polite',内容更新时读屏会自动播报;紧急错误用 assertive。注意 live 区域要预先存在于 DOM 中,动态插入的 live 区域可能不被播报,这是实测中常见的坑。
四、读屏适配:真实听一遍
工具层面,Windows 用 NVDA,macOS 与 iOS 用 VoiceOver,Android 用 TalkBack。开发者至少完整用一种读屏走完核心流程,你会发现大量「看起来没问题」的界面其实不可用:图标按钮没有可访问名称、价格与单位被拆成两段读得支离破碎、轮播图自动切换打断播报。
修复清单:图标按钮加 aria-label;装饰性图标 aria-hidden;组合信息(如「¥99.00 起」)用完整句子组织;自动轮播提供暂停按钮;视频提供字幕,音频提供文字稿。读屏测试不需要成为专家,每次发版前花二十分钟听一遍主流程,就能拦住大部分退化。
五、视觉与动效:对比度、缩放与减弱动态
正文对比度至少 4.5:1,大字号至少 3:1,用浏览器开发者工具或 axe 直接测。不要只靠颜色传达信息:错误提示除了变红还要有文字与图标,图表除了色块还要有纹理或标签。页面要支持 200% 缩放不丢内容,布局用相对单位,避免固定高度容器截断文字。动效方面响应 prefers-reduced-motion 媒体查询,为前庭障碍用户关闭大幅动画与视差。
六、把清单落进日常流程与真实项目
无障碍要进验收标准而不是靠自觉:PR 模板加一条「键盘可达、读屏可懂」自查;CI 里跑 axe 自动扫描,能拦住约三到四成的常见问题;剩余问题靠人工读屏与键盘走查。
练手可以直接改造真实项目:api工厂的开源商城前端 vueMinishop、uni-app-mall(大全见 https://www.it120.cc/help/uq920k.html )是典型的电商界面,商品卡片、购物车角标、优惠券弹窗、订单状态流,恰好覆盖上面所有清单条目。给商品图补 alt、给角标加 aria-live、把优惠券弹窗的焦点管理补全,每修一处就用读屏验证一处。这类项目的商品与订单数据来自 api工厂的开放接口,前端改造不影响后端,很适合做无障碍专项练习;真实上线案例可参考 https://www.it120.cc/cases.html ,对照检查自己的清单完成度。
七、优先级与验收表
| 优先级 | 事项 | 验收方式 |
|---|---|---|
| P0 | 交互元素语义化 | axe 扫描零严重项 |
| P0 | 键盘全流程可达 | 无鼠标走通下单链路 |
| P1 | 焦点管理与可见性 | 弹窗焦点进出正确 |
| P1 | 读屏核心流程 | NVDA/VoiceOver 实测 |
| P2 | 对比度与缩放 | 工具测量达标 |
| P2 | 动效可关闭 | 系统减弱动态生效 |
按这张表逐项打勾,比泛泛地说「我们支持无障碍」有说服力得多。无障碍没有终点,但有明确的起点:今天就把那个 div 按钮换成 button。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。