原生 HTML 模态对话框和无障碍焦点循环的正确实现方法

本文详解如何利用 <dialog> 元素和 inert 属性构建符合 WCAG 2.1 A 级标准的模态交互组件，重点解决 Tab 键焦点循环、焦点捕获、背景禁用及可访问性保障等核心问题，避免手动 JavaScript 焦点陷阱的常见误区。

本文详解如何利用 `

` 元素和 `inert` 属性构建符合 wcag 2.1 a 级标准的模态交互组件，重点解决 tab 键焦点循环、焦点捕获、背景禁用及可访问性保障等核心问题，避免手动 javascript 焦点陷阱的常见误区。

在现代 Web 开发中，实现一个真正无障碍（Accessible）的模态对话框或抽屉式导航菜单（如汉堡菜单），关键不在于“手动劫持 Tab 键并循环焦点”，而在于正确使用语义化原生能力，让浏览器自动完成焦点管理。许多开发者误以为必须监听 keydown、判断焦点位置、再用 focus() 强制跳转——这不仅增加代码复杂度，还极易因事件时序（如 keyup vs keydown）引发“刚抵达最后一个元素就跳回第一个”的反直觉行为（即焦点过早循环），破坏键盘用户的操作预期。

✅ 正确路径：用 <dialog> + showModal() 实现合规模态流

HTML5 原生 <dialog> 是目前唯一被浏览器深度集成、开箱支持无障碍模态行为的元素。调用 .showModal() 后，浏览器会自动：

• 将焦点捕获至对话框内首个可聚焦元素（无需手动 focus()）；
• 限制 Tab 键仅在对话框内部循环（即自然焦点环，非 JS 模拟）；
• 阻断背景内容交互（视觉遮罩 + 逻辑禁用）；
• 支持 Esc 关闭、点击 backdrop 关闭，并在关闭后自动将焦点恢复至触发按钮；
• 设置 aria-modal="true" 和 role="dialog"，并动态管理 aria-hidden 属性。

<!-- 触发按钮 --><button id="openMenuBtn" aria-expanded="false">☰ 菜单</button><!-- 原生模态抽屉 --><dialog id="mobileDrawer">  <h2>导航菜单</h2>  <ul>    <li><a href="/home">首页</a></li>    <li><a href="/about">关于</a></li>    <li><a href="/contact">联系</a></li>  </ul>  <button id="closeDrawerBtn" type="button">✕ 关闭</button></dialog>

const drawer = document.getElementById('mobileDrawer');const openBtn = document.getElementById('openMenuBtn');const closeBtn = document.getElementById('closeDrawerBtn');openBtn.addEventListener('click', () => {  drawer.showModal(); // 自动接管焦点、禁用背景、启用 Tab 循环  openBtn.setAttribute('aria-expanded', 'true');});closeBtn.addEventListener('click', () => {  drawer.close();  openBtn.setAttribute('aria-expanded', 'false');});// 可选：监听 close 事件统一清理状态drawer.addEventListener('close', () => {  console.log('用户已关闭抽屉，焦点已自动返回 openBtn');});

⚠️ 注意：showModal() 是模态语义的黄金标准。若使用 show()（非模态），则不会禁用背景，也不限制 Tab 流——此时手动实现焦点陷阱反而违反无障碍原则，因为用户本应能自由切换上下文。

❌ 错误认知：试图用纯 CSS/HTML 实现“无 JS 焦点循环”

问题中提到的“非 JS 方式让 Tab 回到第一个元素”，本质上是对模态模式的误解。HTML 和 CSS 无法主动干预焦点流转逻辑：:focus 是状态伪类，tabindex 仅控制可聚焦顺序，但没有任何纯 CSS 或 HTML 属性能监听 Tab 键按下并重定向焦点。所谓“无 JS 焦点循环”在技术上不可行，也不符合 WCAG 要求——真正的解决方案是交由浏览器通过语义化模态机制（如 <dialog showmodal>）自动处理。

立即学习“前端免费学习笔记（深入）”；

若因兼容性需降级支持旧浏览器，则必须使用 JavaScript 实现合规焦点陷阱，但应遵循以下规范：

• 打开时：firstFocusableElement.focus()；
• 监听 keydown（非 keyup），捕获 Tab 键；
• 当焦点在最后一个可聚焦元素且按 Shift+Tab 时，跳至最后一个；按 Tab 时，跳回第一个；
• 所有可聚焦元素显式声明 tabindex="0" 或使用原生可聚焦标签（<button>、<a href>、<input> 等）；
• 关闭后：triggerElement.focus() 恢复焦点。

✅ 替代方案：inert 属性用于轻量级非模态遮蔽

当场景不满足 <dialog> 使用条件（如需自定义动画、嵌入复杂布局），可结合 inert 属性禁用背景交互，同时保持语义清晰：

<main inert>  <h1>主页面内容</h1>  <a href="#">此链接不可聚焦、不可点击、对读屏器不可见</a></main><nav aria-label="移动导航">  <h2>菜单</h2>  <ul>    <li><a href="/products">产品</a></li>    <li><a href="/pricing">价格</a></li>  </ul></nav>

inert 的优势在于：它从 DOM 层面移除交互能力与可访问性暴露，比 aria-hidden="true" + pointer-events: none + tabindex="-1" 组合更可靠、更简洁，且已被主流浏览器（Chrome 113+, Firefox 126+, Safari 17.4+）支持。

总结：无障碍模态的核心是“信任浏览器”，而非“控制焦点”

• ✅ 推荐首选：<dialog> + .showModal() —— 语义正确、行为合规、代码极简；
• ✅ 必须设置：<h2> 标题 + aria-labelledby（或 aria-label），确保屏幕阅读器准确播报；
• ✅ 关闭后：焦点自动回归触发源，无需额外 JS；
• ❌ 避免手动焦点循环逻辑，除非你正在 polyfill <dialog> 且已充分测试 WCAG 2.1 SC 2.1.2（无键盘陷阱）；
• ? 兼容性兜底：对不支持 <dialog> 的浏览器，使用 inert + 手动焦点陷阱（参考 WAI-ARIA Authoring Practices 指南）。

真正的无障碍不是“模拟行为”，而是“声明意图”——用 <dialog> 告诉浏览器“这是一个模态上下文”，其余，交给引擎。