tabindex仅合法值为0和-1:tabindex="0"仅用于需键盘访问的非原生元素(如),须配role、keydown监听和:focus-visible;tabindex="-1"专供JS主动聚焦;正整数必须删除,否则破坏焦点流与可访问性。

tabindex 不是用来“排号”或“美化导航”的装饰属性,它是键盘可访问性的底层开关——关了,键盘用户根本进不来;设错值,焦点流直接断裂。
tabindex="0" 该加在哪些元素上才真正有用
只加在本不该可聚焦、但业务又需要键盘进入的容器上,比如 写 生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力:
- 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面;
- 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”;
- 提及位于 `apps/console/src/featur 给一个带 最易被忽略的点是:tabindex 值本身不携带语义,也不触发任何行为——它只是“开门”,门后有没有路、路通不通、路上有没有标识,全靠 、自定义折叠面板标题。原生 、、 本来就进 Tab 流,加了反而可能干扰 SSR hydration 或 React 焦点管理。
tabindex="0",结果屏幕阅读器多读一遍“无意义 div”,键盘用户多停一次却无事可做role 属性(如 role="button"),否则辅助技术读作“段落”或“无名容器”keydown,对 Enter 和 Space 做响应;Space 要 e.preventDefault(),否则页面滚动outline,得补 :focus-visible { outline: 2px solid #007bff; },否则焦点不可见tabindex="-1" 不是隐藏开关,是编程聚焦入口
tabindex="-1" 的唯一合法用途:让一个元素不能被 Tab 键碰到,但能被 .focus() 主动聚焦。模态框打开后聚焦第一个按钮、选项卡切换后聚焦内容区首项、代码编辑器激活时聚焦 ——全靠它。
tabpanel 容器设 tabindex="-1",结果 .focus() 落在空容器上,用户按 Tab 还是跳到页面其他地方.focus(),DOM 找不到,静默失败overflow: hidden 或 position: absolute 遮挡,没配 element.scrollIntoView({ block: 'nearest' }),用户看不见焦点在哪.focus() 对非原生元素会静默失败为什么永远不要用 tabindex="1"
tabindex="1" 不会让它变成“第一个被 Tab 到的元素”,只会把它塞进所有正数里排最小——但多个 tabindex="1" 仍按 DOM 顺序走,和没设一样。更糟的是,一旦混入 tabindex="0" 的链接或按钮,Tab 流变成“正数 → 0 值 → 其他”,完全失控。
tabindex="0",tabindex="1" 更无效,还可能触发警告tabindex="1" 当作逻辑起点,如果它是页脚的“导出按钮”,用户一进页面就听到“导出”,主编辑区上下文全丢tabindex 与视觉顺序无关,只放大 DOM 顺序错位的风险滚动容器 + tabindex 的交互陷阱
overflow-y: auto 的 tabindex="0",本意是让它可聚焦以便键盘导航,但你会发现:聚焦后按方向键无法滚动内容。、)默认启用方向键滚动;对普通 keydown,判断 ArrowUp/ArrowDown 并调用 element.scrollTop
替代(需隐藏边框和 resize 控制器) 等语义化结构替代role、keydown、:focus-visible 和 DOM 顺序共同决定。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










