弹窗焦点管理需手动实现:打开时用 requestAnimationFrame 聚焦首个可交互元素,关闭时恢复触发元素焦点并校验其存在性,Tab 导航需循环控制,inert 属性需兼容降级。
弹窗打开后焦点没落到第一个可交互元素上
浏览器不会自动把焦点移到弹窗里,哪怕你用 modal.showmodal() 或者 display: block 显示了遮罩层。用户按 tab 键依然从页面顶部开始遍历,对屏幕阅读器用户来说,弹窗内容等于“不可达”。
必须手动聚焦。常见错误是等 DOM 渲染完就立刻调 focus(),但若弹窗含异步加载内容(比如 fetch 后插入表单),此时目标元素可能还没挂载。
- 优先选弹窗内第一个
tabindex="0"、button、input、select或带语义的可聚焦元素 - 用
requestAnimationFrame()包一层再聚焦,比setTimeout(..., 0)更可靠 - 如果弹窗由第三方库(如 Bootstrap Modal)控制,查它是否暴露
shown.bs.modal这类事件,别自己硬等
const modal = document.getElementById('my-modal');
modal.showModal();
requestAnimationFrame(() => {
const firstFocusable = modal.querySelector('button, input, select, [tabindex="0"]');
if (firstFocusable) firstFocusable.focus();
});
Esc 关闭弹窗后焦点丢失回原位置
关闭弹窗时若不手动恢复焦点,焦点会落到 document.body 或随机元素上,下一次 Tab 就断链了。尤其当弹窗是从按钮触发时,用户期望 Esc 后焦点回到那个按钮。
关键不是“记下哪个元素打开了弹窗”,而是“在弹窗关闭前存好它”。容易踩的坑是:把触发元素存在闭包里,但该元素后来被移除或重渲染,导致 focus() 失败且无报错。
- 用
data-trigger-id这类属性把触发源 ID 存到弹窗 DOM 上,关闭时再查 - 调用
element.focus()前加个if (element.offsetParent !== null)判断是否还在文档流中 - 避免依赖
document.activeElement—— 弹窗关闭瞬间它可能是body,不是你想要的来源
弹窗内 Tab 键跳出边界
默认 Tab 会一路走到页面底部,穿出弹窗。必须拦截并循环聚焦——但不能简单监听 keydown 拦所有 Tab,否则会破坏屏幕阅读器的内置导航逻辑(比如 NVDA 的 Insert+F7 列表)。
立即学习“前端免费学习笔记(深入)”;
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
正确做法是只在焦点即将离开弹窗时干预,且仅限键盘 Tab/Shift+Tab。重点看 event.key 和当前聚焦元素是否为弹窗内最后一个/第一个可聚焦项。
- 用
modal.querySelectorAll('button, input, select, [tabindex="0"]')预先缓存焦点元素列表 - 监听弹窗容器的
keydown,仅当event.key === 'Tab'且当前聚焦的是列表末尾/开头时,event.preventDefault()并手动跳转 - 别忘了处理
shiftKey:Shift+Tab 应该反向循环
使用 inert 属性禁用背景内容时的兼容性陷阱
inert 是目前最干净的方案:设 document.body.inert = true,背景所有交互和焦点都会被忽略。但它在 Safari 15.4 之前不支持,Chrome 105+ 才稳定,旧版 Edge 完全没戏。
强行 polyfill inert 极易出问题——比如给 body 加 pointer-events: none 会导致滚动失效;用 aria-hidden="true" 又不阻止键盘焦点。
- 检测支持:用
'inert' in HTMLElement.prototype,不支持就退回到手动遍历 +tabindex="-1"+aria-hidden="true" - 注意:给 body 加
inert后,弹窗自身也得显式设inert="false",否则它也会被锁死 - 某些框架(如 React)动态操作
inert属性可能触发重新渲染,优先用原生 DOM 操作
焦点管理最难的不是代码写几行,而是得同时满足三件事:键盘用户能进得去、待得住、出得来,且每次操作都不意外。稍一疏忽,就变成“看得见、摸不着、Tab 不到”的隐形弹窗。


















