《别在 div 和 span 上乱加 aria-label》

Sat, 30 May 2026 00:06:23 GMT

《别在 div 和 span 上乱加 aria-label》

标签：#前端 #Web无障碍 #ARIA #屏幕阅读器 #HTML语义化

总结：
本文通过实测数据揭示了在 div、span 等 generic 角色元素上使用 aria-label 的严重兼容性问题。ARIA 规范明确禁止为 generic 角色命名，而各屏幕阅读器的表现更是天差地别——有的只读标签、有的只读内容、有的两者都读、有的干脆忽略。这种不一致会让依赖辅助技术的用户获得错误信息，属于典型的"好心办坏事"。作者指出 section 和 popover 是例外，前者加标签会自动升级为 region 地标，后者角色会变为 group。

文章要点：
1. ARIA 规范 5.2.8.6 明确把 generic 角色列入"禁止命名"清单，div 和 span 默认就是这个角色
2. 实测 8 组屏幕阅读器+浏览器组合，对带 aria-label 的 div announcement 结果五花八门：VoiceOver 读"News, group"、TalkBack 只读"News"、JAWS/NVDA 完全忽略标签只读内容
3. 空 div 的测试结果更混乱，有的读"News, empty group"、有的完全静默，无法预测用户会听到什么
4. 这种不可预测性对屏幕阅读器用户是灾难性的——你以为在帮忙标注，实际上可能覆盖了真正有用的内容
5. 例外情况：section 元素加 aria-label 会自动从 generic 升级为 region 地标，这是规范允许的；带 popover 属性的 div 角色会变为 group，加标签也合法
6. 正确做法：需要可访问名称时，优先使用语义化标签（如 button、nav）或显式设置 role，而不是在裸 div 上硬塞 aria-label

URL：https://www.matuzo.at/blog/2026/aria-label-generic-elements

Manuel Matuzovic

Don't put aria-label on generic elements like divs

I'm a frontend developer in Graz, specialized in HTML, accessibility, and CSS layout and architecture.

HTML语义化 | 锤子前端

《别在 div 和 span 上乱加 aria-label》