标签页键盘导航失效的根本原因是未接管焦点流。需用button实现页签、动态管理tabindex、切换后立即focus面板首个可聚焦元素,并同步更新aria-hidden与aria-labelledby,禁用display: none隐藏面板。

标签页切换时焦点没跟过去,键盘用户直接“失联”
HTML标签页用鼠标点没问题,但键盘用户按Tab进不到页签、方向键切不了页、回车不生效——根本原因是没接管焦点流。原生button或a元素虽自带可聚焦能力,但默认不会在切换时自动把焦点移到新激活面板的首个可聚焦元素上。
实操建议:
立即学习“前端免费学习笔记(深入)”;
- 页签本身必须是
button(不是div+onclick),并设tabindex="0"(当前激活页签改用tabindex="-1") - 每次切换后,立即调用
focus()到对应面板内第一个可聚焦元素,比如panel.querySelector('input, button, [href], textarea') - 监听
keydown事件:当焦点在页签上时,左/右箭头键应切换到相邻页签;Enter或Space键触发切换并跳转焦点 - 别依赖
aria-modal或role="tablist"自动处理焦点——它们只描述结构,不接管行为
aria-labelledby和aria-hidden不同步,屏幕阅读器读错内容
常见现象:页签切换了,但屏幕阅读器还在读上一个面板的内容,或者读出“未命名区域”。这是因为aria-labelledby指向的ID没更新,或aria-hidden="true"没及时加到非活跃面板上。
实操建议:
立即学习“前端免费学习笔记(深入)”;
- 每个页签
button要有唯一id,对应面板用aria-labelledby指向它,例如aria-labelledby="tab-home" - 非活跃面板必须设
aria-hidden="true";活跃面板设aria-hidden="false"(显式写比不写更稳妥) - 不要只靠
display: none隐藏面板——它会让屏幕阅读器彻底忽略该节点,连aria-hidden都失效;优先用visibility: hidden+position: absolute组合 - 动态更新
role="tabpanel"的aria-labelledby值,确保始终与当前页签ID一致
多个标签页共存时,导航上下文丢失
页面里既有顶部主导航标签页,又有文章内嵌的代码示例标签页,屏幕阅读器全报“标签页”,用户分不清在哪操作。这不是功能缺陷,是语义缺失。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
实操建议:
立即学习“前端免费学习笔记(深入)”;
- 外层容器加
role="tablist"的同时,必须配aria-label说明用途,如aria-label="文档版本切换"或aria-label="API响应格式示例" - 避免泛化命名,像
aria-label="Tabs"或aria-label="Navigation"等于没标 - 如果页签文字本身已明确(如“JSON”“XML”“YAML”),可用
aria-label补充上下文,例如aria-label="响应格式:JSON" - 同一页面多个
tablist时,确保各组id前缀不重复,防止aria-labelledby跨组错连
表单状态在标签页切换后丢失
用户在“设置”标签页填了一半表单,切到“帮助”再切回来,输入框空了、复选框重置了、富文本编辑器内容没了——因为用了display: none隐藏面板,导致内部input失去焦点且DOM被浏览器回收。
实操建议:
立即学习“前端免费学习笔记(深入)”;
- 含表单或动态资源(如
iframe、video)的标签页,禁用display: none;改用visibility: hidden+position: absolute+inset: 0(或top: -9999px)移出视口但保留在DOM中 - 切换前手动保存关键状态:监听页签
click或keydown,用dataset暂存input.value、textarea.value、checkbox.checked等 - 激活面板时,检查对应
dataset是否存在,存在则还原;注意不要覆盖用户刚输入但尚未提交的值 - 对富文本编辑器(如
contenteditable),需额外监听input事件做防抖缓存,否则频繁切换会卡顿
最易被忽略的是:焦点移动和aria-hidden更新必须在同一个同步任务里完成。异步延迟哪怕1ms,屏幕阅读器就可能读出错误状态。别用setTimeout或Promise.then做焦点跳转——直接element.focus()后立刻跟panel.setAttribute('aria-hidden', 'false')。


















