tabindex仅控制元素能否聚焦、是否入Tab流及相对位置;0值最安全,-1用于编程聚焦,禁用正整数;需配合role、focus样式、inert等确保可访问性。

tabindex 不是用来给元素“编号排序”的开关,它只决定三件事:元素能否被聚焦、是否进入 Tab 流、在流中相对于 DOM 顺序的位置——值的正负零直接对应这三种行为,错用正整数会破坏键盘导航逻辑,尤其在动态组件中极易引发焦点丢失或跳转混乱。
tabindex="0" 是最常用也最安全的启用方式
给 设为 -1 后,元素无法通过 Tab 键到达,但能用 浏览器只看是否 > 0,不严格按数值排序;多个正数时虽按升序排,但一旦漏值(比如只有 1 和 3),2 不会补位,且原生可聚焦元素会被挤到最后,整个 Tab 流就断层了: 把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件(幻灯片风格)。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本,并且希望生成演示用的 HTML 时触发。支持任意内容来源:iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区,并通过企微直接发送给用户。触发词示例:帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。 不可用( 真正难的不是写对 或自定义控件加 tabindex="0",能让它按 HTML 源码顺序自然加入 Tab 流。但它不是“开箱即用”的交互元素:
keydown 并判断 event.key === 'Enter' 或 ' '
role="button"(或其他匹配角色):focus-visible 或至少 :focus CSS 规则、)无需加 tabindex="0",加了反而多余tabindex="-1" 是编程聚焦的唯一可靠入口
.focus() 主动聚焦——这是模态框、选项卡、下拉菜单等动态组件的焦点控制核心:
.focus(),前提是该元素有 tabindex="-1"
document.activeElement 记录或传参保存tabindex="-1" 不等于视觉隐藏:仅设它,元素仍可能被 Tab 到(如果 CSS 用 opacity: 0 或 position: absolute; left: -9999px 隐藏),此时需配合 inert 属性或显式移除 tabindex
绝对不要用正整数 tabindex(如 1、2、5)
tabindex 值不一致,会触发 hydration 警告 自动脱离 Tab 流,无需额外设 tabindex="-1"
隐藏/禁用元素的 tabindex 处理要格外小心
disabled)或视觉隐藏(display: none / visibility: hidden)的元素,即使设了 tabindex 也不会出现在 Tab 流中。但要注意:
aria-hidden="true" 不影响 tabindex 行为,若同时存在,需显式设 tabindex="-1" 或移除 tabindex
opacity: 0 或 position: absolute; left: -9999px 隐藏的元素,仍可能被 Tab 到,应配合 inert(现代浏览器支持)或 tabindex="-1"
tabindex 和 inert 状态,否则焦点可能落在不可见元素上tabindex,而是在组件状态频繁变化时,始终让焦点落在用户预期的位置——这需要把焦点管理当作和数据流一样严肃的状态来维护,而不是加个属性就完事。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










