本文深入探讨了在实现基于JavaScript的导航菜单时，屏幕阅读器（如NVDA）无法正确播报aria-expanded状态的问题。核心在于将导航菜单误用为模态对话框，以及对焦点管理和ARIA模式理解的不足。文章将详细解释为何这种实现方式会干扰可访问性，并推荐使用更符合Web可访问性指南的菜单按钮或披露模式，以确保用户体验的无障碍性。
在现代Web开发中，提供无障碍的用户体验至关重要，特别是对于依赖屏幕阅读器的用户。当我们在实现交互式组件（如导航菜单）时，正确使用ARIA（Accessible Rich Internet Applications）属性和理解其背后的行为模式是确保可访问性的关键。本文将分析一个常见问题：当一个导航菜单被实现为类似模态对话框的覆盖层时，屏幕阅读器无法正确播报其展开/折叠状态。
问题场景分析
开发者通常会创建一个“汉堡”按钮，点击后显示一个全屏覆盖的导航菜单（#navbarNav）。为了视觉效果，当导航菜单展开时，页面上的其他元素（如用户账户信息#member-un）可能会被隐藏。然而，当开发者尝试通过memberUN.style.display = "none";和memberUN.style.display = "flex";来控制这些元素的显示时，屏幕阅读器（如NVDA）便停止播报汉堡按钮的aria-expanded状态（“Expanded”或“Collapsed”）。
以下是导致此问题的核心JavaScript代码片段：
let hamburger = document.getElementById("hamMenuButton");
let shown = false;
hamburger.addEventListener("click", function () {
if (shown) { // if #navbarNav is showing
hideNN();
} else { // if not
showNN();
}
});
function showNN() {
// 导致问题的代码行
memberUN.style.display = "none";
shown = true;
}
function hideNN() {
// 导致问题的代码行
memberUN.style.display = "flex";
shown = false;
}以及相关的HTML结构：
<header>
<section class="dropdown my-1" id="member-un">
<button class="dropdown-toggle" type="button" id="dropdownMenuButton" data-bs-toggle="dropdown" aria-haspopup="true" tabindex="0" aria-expanded="false">
<p>Hello, John Smith</p>
</button>
<section class="dropdown-menu dropdown-menu-right p-0" aria-labelledby="dropdownMenuButton">
<a class="dropdown-item py-3" href="" id="drop-logout">Logout</a>
</section>
</section>
<nav class="navbar" id="hamburger-menu">
<button class="navbar-toggler"
id="hamMenuButton"
type="button"
data-bs-toggle="collapse"
data-bs-target="#navbarNav"
aria-expanded="false"
aria-controls="navbarNav">
Menu
</button>
</nav>
</header>
<section class="collapse py-5" id="navbarNav">
<p>Hello, John Smith</p>
</section>深入解析可访问性问题
问题的根源在于对模态对话框（Dialog）和导航菜单的不同ARIA模式的混淆以及焦点管理机制的误解。
-
模态对话框与aria-expanded的冲突：
- 模态对话框（Modal Dialog）的主要特点是强制用户关注其内容，并通常会捕获焦点，使其无法移出对话框范围。
- 根据ARIA创作实践指南（APG）的对话框模式，当对话框打开时，焦点应立即转移到对话框内部的某个元素上。
- 一旦焦点被捕获在对话框内，触发按钮（在此例中是汉堡按钮）的状态（aria-expanded）将不再被屏幕阅读器播报，因为用户已不再与其交互。屏幕阅读器关注的是当前焦点所在元素。
- Bootstrap框架通常不会为与其对话框模式一起使用的元素自动更新aria-expanded状态，因为它假定焦点会转移。
-
隐藏外部元素的不必要性：
java-api-doc-generator下载分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 当一个模态对话框打开时，其目的是阻止用户与对话框外部的内容交互。通常会伴随一个背景遮罩（backdrop）来强化这一点。
- 在这种情况下，通过display: none;隐藏对话框外部的元素（如#member-un）对屏幕阅读器用户来说是多余的，因为他们的焦点已被限制在对话框内，无法感知到外部元素的变化。对于普通用户，遮罩也已经足够明确地表明外部内容不可用。
-
导航菜单不应作为模态对话框实现：
- 将一个简单的导航菜单实现为全屏模态对话框是一种不常见的做法。模态对话框适用于需要用户立即响应或提供特定信息的场景，例如确认框、设置面板等。
- 导航菜单的目的是提供页面或网站内的跳转链接，其交互模式通常更为轻量级，不应过度干扰用户对主内容的访问。
推荐的ARIA模式与解决方案
为了实现一个可访问的导航菜单，同时确保屏幕阅读器能正确播报其状态，我们应该避免将其视为模态对话框，并采用更合适的ARIA模式。
-
菜单按钮模式 (Menu Button Pattern)：
- 当一个按钮触发一个包含一组操作或导航链接的弹出菜单时，可以使用此模式。
- 按钮应具有aria-haspopup="menu"属性，指示它会弹出一个菜单。
- 当菜单打开时，按钮的aria-expanded属性应设置为true；关闭时设置为false。
- 焦点管理：当菜单打开时，焦点通常会移动到菜单的第一个可聚焦项上。当菜单关闭时，焦点应返回到菜单按钮。
-
披露模式 (Disclosure Pattern)：
- 当一个按钮控制一个区域的显示和隐藏时（例如，展开/折叠内容），可以使用此模式。
- 按钮应具有aria-expanded属性，指示其控制的区域是否展开。
- 按钮应具有aria-controls属性，指向其控制的区域的ID。
- 焦点管理：在此模式下，焦点通常停留在触发按钮上，并且屏幕阅读器会播报按钮的aria-expanded状态。被控制区域的内容会根据aria-expanded状态进行显示或隐藏。
对于本例中的“汉堡”导航菜单，披露模式通常是更合适的选择。Bootstrap的collapse组件本身就非常符合披露模式。
改进思路与实践：
-
利用Bootstrap的collapse组件： Bootstrap的collapse组件已经内置了对aria-expanded和aria-controls的良好支持。
- 确保你的汉堡按钮（#hamMenuButton）正确设置了data-bs-toggle="collapse"、data-bs-target="#navbarNav"、aria-controls="navbarNav"。
- Bootstrap会自动处理aria-expanded的切换。
- 避免手动干预display属性来隐藏无关元素： 如果#navbarNav被设计为全屏覆盖，那么外部元素的可见性通常不需额外处理。如果确实需要隐藏，考虑使用visibility: hidden;而不是display: none;，因为display: none;会从可访问性树中移除元素，而visibility: hidden;只是使其不可见，但保留其在DOM中的存在。不过，对于导航菜单，通常不需要在打开时隐藏其他页面元素。
- 焦点管理： 如果你坚持使用类似模态对话框的导航，那么你必须手动实现完整的ARIA对话框模式，包括焦点捕获、焦点陷阱、以及在关闭时将焦点返回到触发元素。但再次强调，这对于导航菜单来说是过度设计。
- 测试： 始终使用屏幕阅读器（如NVDA、JAWS、VoiceOver）进行测试，以确保你的实现符合预期，并且所有交互都对残障用户友好。
示例代码调整建议（基于披露模式）：
保留Bootstrap collapse组件的默认行为，移除手动控制memberUN显示的代码：
// 移除手动控制 #member-un 显示/隐藏的代码
// let memberUN = document.getElementById("member-un");
// function showNN() {
// memberUN.style.display = "none"; // 移除此行
// shown = true;
// }
// function hideNN() {
// memberUN.style.display = "flex"; // 移除此行
// shown = false;
// }
// 保持 Bootstrap collapse 的默认行为
// 确保 #hamMenuButton 具有正确的 data-bs-toggle, data-bs-target, aria-controls 属性
// Bootstrap 会自动处理 aria-expanded 的切换和屏幕阅读器播报
let hamburger = document.getElementById("hamMenuButton");
// 移除自定义的 click 事件监听器，让 Bootstrap 处理
// hamburger.addEventListener("click", function () {
// // ...
// });通过移除与memberUN相关的display操作，并依赖Bootstrap collapse组件的内置行为，屏幕阅读器将能够正确地播报汉堡按钮的aria-expanded状态。
总结
在开发Web界面时，尤其是在涉及交互式组件时，理解和正确应用ARIA模式至关重要。将一个导航菜单误用为模态对话框会导致焦点管理问题，进而影响屏幕阅读器的播报。对于展开/折叠式导航菜单，推荐使用ARIA披露模式，并充分利用现有框架（如Bootstrap）提供的组件，它们通常已经内置了良好的可访问性支持。始终通过实际的屏幕阅读器进行测试，是确保无障碍体验的最后一道防线。
