JAWS屏幕阅读器无法读取VS Code WebView及欢迎页的标题与文本

一、WebView中独立文本无法被JAWS读取的解决办法 #

• 用语义化标签标记文本：标题类文本使用<h1>至<h6>标签，段落、描述文本使用<p>标签，JAWS会自动识别这类语义化元素并读取内容；
• 补充ARIA属性增强识别：对于非语义化容器包裹的静态文本，添加aria-label（直接标注文本内容）或aria-describedby（关联描述元素），如果需要JAWS主动读取动态加载的文本，可添加aria-live="polite"属性；
• 调整JAWS读取模式：按下Insert+Ctrl+R切换至文档模式，应用模式下JAWS会优先聚焦可交互控件，容易跳过静态文本；
• 检查WebView配置：确保扩展的WebView未禁用脚本，且页面根元素或文本容器未设置aria-hidden="true"属性，避免文本被无障碍工具忽略。

二、VS Code欢迎页标题无法被JAWS读取的问题 #

这不是操作失误，属于VS Code自身的无障碍兼容性bug。欢迎页的「Start」「Walkthroughs」「Recent」等标题未使用语义化标签，也缺少必要的无障碍属性，导致JAWS无法识别读取。你可以通过VS Code开发者工具（Ctrl+Shift+I）查看DOM结构验证这一点，该问题已有相关官方反馈，需等待VS Code更新修复。

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