.tsx和.jsx文件是否存在无障碍功能问题。它会标记无障碍技术(例如VoiceView屏幕阅读器)无法描述或无法正确操作的组件,并为大多数问题提供一键修复。A11y检查器默认开启,且无法关闭。
A11y检查器使用与Vega ESLint插件相同的无障碍功能规则。在编写代码时使用检查器来发现问题。使用ESLint插件从命令行或构建管道中检查您的应用。
先决条件
- Vega Studio版本0.24.2或更高版本。有关安装说明,请参阅设置Vega Studio。
查找无障碍功能问题
A11y检查器会分析您打开的每个.tsx和.jsx文件,并在编辑器中使用波浪下划线标记问题。下划线颜色显示严重性:
- Blocker(阻碍)(红色)- 无障碍技术无法使用该元素。先修复此类问题。
- Critical(关键)(黄色)- 该元素使用了已弃用的无障碍功能属性。
- Major(重要)(蓝色)- 该元素缺少帮助用户理解或操作它的信息。
A11y: 2 broken · 1 bad。批准包含Fix(修复)、Preview(预览)和Explain(解释)按钮。
扫描您的整个工作区
检查器会在您打开文件时对其进行检查。要同时检查工作区中的所有.tsx和.jsx文件,请执行以下操作:
- 打开命令面板。
- 运行A11y检查器: 运行Lint。
在侧边栏中查看问题
Accessibility(无障碍功能)视图列出了工作区中的所有无障碍功能问题。要将其打开,请从命令面板中运行A11y检查器: 显示侧边栏。 要更改问题的组织方式,请在视图的标题栏中选择Group by Severity(按严重性分组)或Group by File(按文件分组):- Group by Severity((按严重性分组))- 将Blocker(阻碍)、Critical(关键)和Major(重要)问题列在一起。
- (按文件分组)(按文件分组)- 在问题出现的文件下列出问题。
选择某个问题可在编辑器中转到对应位置。
了解问题
要查看问题摘要,请将鼠标悬停在带下划线的元素上。工具提示会显示规则名称、诊断消息、严重性以及文档链接。 有关更多详情,请在CodeLens批注中选择Explain(解释)。Explain(解释)面板显示:- 规则名称和严重性
- 诊断消息
- 有关如何解决问题的指南
- 前后代码示例
- 规则的禁止语法
- 相关文档的链接
修复问题
您可以一次修复一个问题,也可以一次性修复工作区中所有可修复的问题。修复单个问题
- 选择问题旁边的灯泡图标,或在CodeLens批注中选择Fix(修复)。
- 选择要应用的修复方法。 检查器会应用修复,该元素的波浪下划线随即消失。
- 添加缺失的
aria-label。 - 添加缺失的
role。 - 添加缺失的
aria-checked或aria-selected状态。 - 添加缺失的
accessibilityHint。 - 重命名已弃用的属性,例如将
accessibilityLabel重命名为aria-label,或将accessibilityRole重命名为role。 - 替换无效的角色值,例如将
header替换为heading,或将image替换为img。
在应用修复之前进行预览
-
在CodeLens批注中选择Preview(预览)。
检查器会以内联方式显示建议的更改,并以绿色标注。
- 要应用修复,请选择Accept Fix(接受修复);要丢弃修复,请选择“Revert(恢复)。
修复工作区中的所有问题
- 打开命令面板。
- 运行A11y检查器: 全部修复。 您还可以在Accessibility(无障碍功能)视图的标题栏中选择Fix All(全部修复)。
禁止问题
如果某个问题不适用于某个元素,则可以将其禁止。要添加禁止注释,请从灯泡菜单中选择禁止操作,或自行添加注释。
例如,要对一张装饰性图片禁止缺少标签规则:
eslint-disable-next-line注释会禁止下一行的所有规则。
无障碍功能规则
在Vega ESLint插件中,阻碍规则默认为
error,关键和重要规则默认为warn。
相关主题
- 安装和配置Vega ESLint插件
- Vega开发者无障碍功能资源
- 可访问性属性 (React Native 0.83)
- 可访问性属性 (React Native 0.72)
- Vega Studio命令

