JAWS、Narrator屏幕阅读器无法读取单字符标题问题咨询

架构老林

2026-8-26

问题成因

该异常是JAWS、Windows Narrator两款屏幕阅读器的固有解析规则导致的已知兼容问题：

两款阅读器对非交互元素上绑定的aria-label属性内置了无意义内容过滤逻辑，当aria-label的取值长度仅为1个字符（单数字、单字母）时，会被判定为无意义的冗余噪声，直接从朗读队列中剔除，最终表现为朗读空白。
该过滤规则仅对长度为1的aria-label生效，取值长度达到2位及以上时不会触发过滤，因此多字符内容可被正常朗读。
NVDA未内置这套单字符过滤逻辑，因此不存在该兼容问题。

额外需要注意：示例代码的写法本身不符合ARIA使用规范——原生标题标签（h1-h6）内部已经存在明确的文本内容时，不需要额外添加和内部文本完全一致的aria-label重复声明可访问名称，这类冗余写法刚好触发了上述阅读器的过滤bug。

修复方案

按照优先级从高到低可选择以下方案：

删除冗余ARIA属性（推荐）
直接移除标题标签上重复的aria-label属性，屏幕阅读器默认会原生读取标签内部的文本内容，完全不会触发单字符过滤bug，是最符合无障碍规范的写法。修改后代码如下：
```
<div class="box">
    <h2 class="name">Notes</h2>
    <h1 class="description">1</h1>
</div>
```
零宽空格填充（特殊场景适用）
如果存在业务场景必须保留aria-label（比如元素视觉显示文本和朗读文本不一致），可以在aria-label的单字符后追加零宽空格，将属性值长度拉到2位以上绕过过滤，零宽空格不会被阅读器读出，不会影响实际朗读效果。示例：
```
<h1 class="description" aria-label="1&#8203;">1</h1>
```
注意不要使用普通空格填充，两款阅读器都会自动裁剪aria-label首尾的普通空格，依然会触发单字符过滤。
强制文本角色（备选）
给对应元素添加role="text"属性，强制阅读器将元素识别为纯文本节点，跳过单字符过滤逻辑。但该方案会覆盖h标签原生的heading语义，破坏屏幕阅读器的标题导航功能，非必要不使用。

内容的提问来源于stack exchange，提问作者wanderingF00l