Tab组件必须用role="tablist"包裹所有标签页,否则屏幕阅读器无法识别为可切换标签组;每个tab需设role="tab"、aria-controls指向对应panel,面板用role="tabpanel"并匹配id,同步管理aria-selected、aria-hidden与tabindex以保障键盘导航和无障碍访问。

Tab组件必须用role="tablist"包裹所有标签页
不加这个角色,屏幕阅读器无法识别这是一组可切换的标签页。只用 常见错误是直接套个 光有tab没用,内容区得让屏幕阅读器知道“这是刚才选中的那个tab对应的内容”。否则用户切过去,听到的只是空白或一堆孤立段落。 典型坑是把面板写成普通 仅靠鼠标点tab不够。视障用户依赖键盘导航,而默认 很多实现只监听 实现 Markdown↔ HTML 互转,支持导出 PDF,用于用户请求的文档格式转换。 比如“切换到设置页”这种说明性文字,视觉上不需要显示,但对屏幕阅读器很重要。用 有人图省事写
实际复杂点不在结构而在状态同步:tab的默认没有语义,哪怕视觉上排成一排也没用。role
tablist里每个标签页用,别用或——前者会触发跳转,后者不可聚焦也不响应键盘操作tab需带aria-controls指向对应面板ID,例如aria-controls="panel-1"
aria-selected="true",其他为"false"
面板区域必须用
role="tabpanel"且与tab关联aria-labelledby但ID拼错、大小写不一致——AT直接忽略关联。aria-controls值完全一致
aria-hidden="false",隐藏的面板设为"true"(注意不是display: none,那会让AT彻底跳过)aria-labelledby="tab-1",让AT读出“面板:XXX”,提升上下文感知role="tablist",除非是子级标签页——否则焦点流容易混乱键盘交互必须支持
ArrowLeft/ArrowRight切换tab键只能顺序进入每个可聚焦元素,没法在tab之间快速跳转。click事件,忘了keydown,结果键盘用户按方向键毫无反应,只能反复Tab进出,体验极差。
tablist容器绑定keydown事件,捕获ArrowLeft和ArrowRight
aria-selected、tabindex(激活tab设为0,其他设为-1),并聚焦到目标tabHome/End键支持:Home跳第一个,End跳最后一个preventDefault()对空格/回车的默认行为——它们该触发tab切换,不是滚动页面视觉隐藏但AT可读的文本需用
sr-only类而非display: none
display: none或visibility: hidden会把它从AT中彻底剔除。,结果AT读出来就是“tab,未命名”,用户完全不知道这是干啥的。
.sr-only:绝对定位+宽高0+溢出隐藏+clip裁剪,确保视觉不可见但AT可读tab按钮内部,建议放切换至设置这类辅助文本aria-selected、面板的aria-hidden、焦点位置、tabindex值,四者必须严格一致,漏掉任何一个,AT就会读错或跳过内容。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










