近日，多位前端开发者和无障碍测试人员反映，在Windows 11系统下，微软内置的屏幕阅读器“讲述人”（Narrator）与流行的React UI库Ant Design（AntD）的按钮组件存在奇怪的交互问题。具体表现为：当页面中存在标题元素（Heading，如h1-h6）时，AntD按钮的焦点状态、角色朗读和交互反馈出现异常，导致视障用户无法正常辨识按钮功能，甚至陷入操作死循环。
问题再现：标题干扰按钮的ARIA语义
据多位开发者在GitHub和Twitter上提交的bug描述，该问题在Windows 11 22H2/23H2版本上均可复现。当AntD的Button组件与一个或多个标题元素出现在同一文档流中时，讲述人在聚焦按钮时可能错误地将按钮朗读为“标题层级”，或者完全跳过按钮的“按钮”角色声明，直接朗读其子文本节点。更极端的情况是，讲述人会将按钮视为一个“分组”或“可展开项”，导致用户无法通过空格键或回车键触发点击。
以最常见的场景为例：一个包含<h2>用户信息</h2>和<Button type="primary">提交</Button>的页面，在讲述人扫描模式下，用户使用Tab键聚焦按钮时，听到的可能是“提交，标题2级”或“提交，按钮，已折叠”，而非预期的“提交，按钮”。这直接违反了WCAG 2.1成功标准4.1.2（名称、角色、值）的要求。
触发条件：并非所有标题都惹祸
进一步测试发现，并非所有标题都会触发该异常。问题似乎与标题元素是否直接位于按钮的DOM祖先链中有关。如果标题与按钮共享同一个父容器（如<div>），且该容器未显式设置role，则讲述人可能将按钮的语义继承或误读为标题的上下文。另一种情况是，当AntD按钮使用了aria-label或aria-labelledby属性时，标题的文本内容会意外覆盖按钮的自定义标签。
一名在GitHub issue中留言的前端工程师表示：“我们用AntD重构了公司的后台管理界面，在无障碍测试中，视障员工反馈‘提交’按钮完全无法点击。后来发现只要删除页面顶部的<h1>，问题就消失了。” 这一现象暗示讲述人在解析DOM树时存在对标题元素的“过度关联”，可能将其视为可导航的“地标”或“区域”边界。
影响范围：数百万AntD用户面临无障碍风险
Ant Design作为国内最流行的企业级React UI库之一，被广泛应用于阿里云、蚂蚁集团、字节跳动等企业的内部系统和对外平台。据npm官方统计，@ant-design/icons和antd包每周下载量超过400万次。这意味着任何依赖AntD构建的网站或应用，在Windows 11系统下使用讲述人浏览时，都可能遭受按钮功能失效的问题。
尤其值得关注的是，Windows 11的“讲述人”功能在近年被微软定位为“核心无障碍工具”，并随着系统更新不断强化。它已取代旧版“讲述人”和部分第三方屏幕阅读器的市场份额。然而，此次发现的bug表明，微软在兼容现代前端框架方面仍存在盲区。
临时解决方案：开发者与用户双管齐下
截至发稿，微软和Ant Design官方尚未发布正式补丁。不过，社区已提出几种临时应对方案：
- 为按钮添加显式role：在AntD Button上手动添加
role="button"，或使用aria-role="button"属性，强制覆盖讲述人的默认解析。 - 隔离标题与按钮的DOM层级：避免标题与按钮共用同一个无语义容器，或为容器添加
role="presentation"。 - 升级屏幕阅读器：在Windows 11中暂时切换至NVDA或JAWS等第三方工具，它们对AntD组件的支持更成熟。
- 调整页面结构：将标题置于
<header>或<section>标签内，利用HTML5语义元素帮助讲述人正确划分区域。
对于普通用户，微软官方论坛建议在“讲述人设置”中关闭“按标题导航”模式，但此举会牺牲其他导航便利性。
专家观点：ARIA与原生语义的兼容性之痛
无障碍咨询师李明（化名）表示，该问题的本质是Windows 11讲述人对HTML5标题元素的特殊处理逻辑与Ant Design生成的复杂ARIA树之间的冲突。“讲述人在扫描模式下会为每个标题自动生成一个可导航的‘H标志’，并尝试为标题后的第一个交互元素建立上下文关联。AntD按钮的嵌套结构可能欺骗了讲述人的算法，让它以为按钮本身就是一个标题容器。”
他建议前端开发者避免在按钮内部使用任何标题标签（如<h3>），并严格遵循ARIA authoring practices中对按钮组件的规范。同时，他希望微软能尽快发布针对Chromium Edge和WebView2的讲述人更新，因为大多数AntD应用运行在浏览器环境中。
结语：数字无障碍需要生态协同
从用户角度看，一个“提交”按钮无法被屏幕阅读器识别，可能意味着无法完成购票、提交表单、登录账户等基本操作。此次事件再次提醒我们，无障碍不是单一厂商的责任，而是浏览器、操作系统、前端框架三方协同的结果。在Windows 11用户基数持续增长、Ant Design生态不断扩大的背景下，修复此bug刻不容缓。我们也将持续关注微软和Ant Design团队的官方回应。