本文旨在解决屏幕阅读器在自定义单选按钮组件中误报状态的问题。当包含 `tabindex` 属性的父级 `div` 元素抢占焦点时，屏幕阅读器可能无法正确识别实际 `input` 元素的选中状态。通过移除父级 `div` 上的 `tabindex` 属性，我们可以确保焦点直接落在原生 `input` 元素上，从而实现屏幕阅读器准确播报其选中状态，提升用户体验。
理解屏幕阅读器对自定义单选按钮的误报
在构建自定义 UI 组件时，开发者经常会遇到屏幕阅读器（如 Narrator）无法正确播报元素状态的问题。一个常见的场景是，当焦点移动到一个自定义单选按钮组时，屏幕阅读器可能会错误地宣布一个实际上已选中的按钮为“未选中”。这种误报会严重影响依赖屏幕阅读器用户的体验，使其难以理解当前界面状态。
考虑以下 HTML 结构，它尝试构建一个自定义的单选按钮组：
<div>
<div tabindex="0" role="radio">
<ul>
<li class="react-custom-radio-link">
<input type="radio" name="IsPrivateProfile" id="Public" aria-checked="true">
<label for="Public">Public</label></li>
</ul>
</div>
<div tabindex="0" role="radio">
<ul class="react-custom-radio-button">
<li class="react-custom-radio-link">
<input type="radio" name="IsPrivateProfile" id="Private" aria-checked="false" checked=""><label for="Private">Private</label></li>
</ul>
</div>
</div>在这个示例中，我们有两个 div 元素，每个都带有 tabindex="0" 和 role="radio"。它们内部包含实际的 元素，并使用 aria-checked 属性来指示其选中状态。问题在于，当屏幕阅读器的焦点移动到外部的 div 元素时，它会优先读取该 div 的 role="radio" 属性，但却无法正确解析其内部 input 元素的 aria-checked 状态，从而导致错误的播报。例如，尽管 id="Private" 的 input 元素通过 checked 属性明确表示为选中状态，屏幕阅读器在聚焦到其父 div 时仍可能播报为“未选中”。
核心原因分析：焦点管理与ARIA属性的冲突
造成屏幕阅读器误报的核心原因在于不当的焦点管理。当一个元素被赋予 tabindex="0" 时，它就变得可聚焦，并被纳入 Tab 键的导航序列中。在本例中，外部的 div 元素由于设置了 tabindex="0"，成为了一个独立的焦点接收者。
屏幕阅读器在处理焦点时，会首先识别获得焦点的元素。当焦点落在带有 role="radio" 的 div 上时，屏幕阅读器会将其识别为一个单选按钮。然而，这个 div 本身并没有直接的 aria-checked 属性来指示其选中状态，或者它无法智能地向下穿透到其子 input 元素来获取这个状态。因此，屏幕阅读器可能会推断出一个默认的“未选中”状态，或者根本无法获取到正确的状态信息。只有当用户进一步操作，使焦点最终落到实际的 元素上时，屏幕阅读器才能正确地读取 aria-checked 或 checked 属性，并播报正确的选中状态（例如“已选中，1/2”）。
构建 Shopify 嵌入式应用（Embedded App）的开发技能：基于 @shopify/shopify-app-react-router + React Router v7 + Admin API 2026-04。覆盖 shopifyApp 配置、authenticate.admin 的 GraphQL/REST 调用、Webhook 校验、Session 存储、订阅计费、App Bridge 导航、部署，并新增：适用场景判断、安全最佳实践、错误处理与容错、最佳实践、常见问题 FAQ、高级场景。G
这种行为模式表明，将 tabindex 和 role="radio" 同时应用于一个容器元素，而实际的交互和状态管理却发生在内部的原生 input 元素上，会造成焦点流与语义信息的脱节。
解决方案：优化焦点流与语义结构
要解决这个问题，最直接且有效的方法是移除父级容器 div 上的 tabindex 属性。这样可以确保屏幕阅读器的焦点直接落在原生的 元素上，从而让屏幕阅读器能够正确地识别和播报其 checked 或 aria-checked 状态。
以下是修正后的 HTML 结构：
<div>
<div role="radio">
<ul>
<li class="react-custom-radio-link">
<input type="radio" name="IsPrivateProfile" id="Public" aria-checked="true">
<label for="Public">Public</label></li>
</ul>
</div>
<div role="radio">
<ul class="react-custom-radio-button">
<li class="react-custom-radio-link">
<input type="radio" name="IsPrivateProfile" id="Private" aria-checked="false" checked=""><label for="Private">Private</label></li>
</ul>
</div>
</div>通过移除 tabindex="0"，外部 div 不再是独立的焦点接收者。当用户使用 Tab 键导航时，焦点将跳过这些 div，直接定位到 元素。原生 input 元素天生具有可聚焦性，并且屏幕阅读器对其 type="radio" 和 checked（或 aria-checked）属性有内置的理解和支持。这样，屏幕阅读器就能准确地播报：“Public，单选按钮，已选中，1/2” 或 “Private，单选按钮，未选中，2/2”（根据实际状态）。
最佳实践与注意事项
- 优先使用原生 HTML 元素： 在构建 UI 组件时，应尽可能利用原生 HTML 元素（如 ,
- 谨慎使用 tabindex： 只有当原生元素无法满足需求，且需要使非交互式元素可聚焦时，才应考虑使用 tabindex="0"。对于容器元素，除非有明确的理由（例如实现复杂的复合组件的键盘导航），否则不应设置 tabindex。
- ARIA 属性与原生语义结合： ARIA（Accessible Rich Internet Applications）属性是增强无障碍性的强大工具，但它们应与正确的 HTML 语义结合使用。避免使用 ARIA 属性来“修复”不当的 HTML 结构或焦点管理。
- 避免冗余的 role 属性： 如果一个元素已经具有其语义角色（例如 本身就是单选按钮），则无需在父级容器上重复设置 role="radio"。这可能导致屏幕阅读器混淆。
- 彻底的测试： 在开发无障碍组件后，务必使用多种屏幕阅读器（如 Windows Narrator, NVDA, JAWS）和不同的浏览器进行测试。实际的用户体验是检验无障碍性是否成功的最终标准。模拟键盘导航，并仔细聆听屏幕阅读器的播报内容，确保其准确无误。
总结
确保屏幕阅读器正确播报自定义 UI 组件的状态，是构建无障碍网页的关键一环。对于自定义单选按钮组件，当屏幕阅读器误报其状态时，往往是由于不当的焦点管理导致。通过移除父级容器上冗余的 tabindex 属性，我们可以将焦点流引导至原生的 input 元素，从而利用其内置的无障碍特性，确保屏幕阅读器能够准确、清晰地向用户传达当前组件的选中状态。遵循无障碍最佳实践，并进行充分的测试，是提升所有用户体验的基石。
