as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content
Vega Studio 中的A11y 检查器会在您编辑时检查应用的.tsx和.jsx文件是否存在无障碍功能问题。它会标记无障碍技术(例如VoiceView屏幕阅读器)无法描述或无法正确操作的组件,并为大多数问题提供一键修复。A11y检查器默认开启,且无法关闭。 A11y检查器使用与Vega ESLint插件相同的无障碍功能规则。在编写代码时使用检查器来发现问题。使用ESLint插件从命令行或构建管道中检查您的应用。

先决条件

  • Vega Studio版本0.24.2或更高版本。有关安装说明,请参阅设置Vega Studio。

查找无障碍功能问题

A11y检查器会分析您打开的每个.tsx和.jsx文件,并在编辑器中使用波浪下划线标记问题。下划线颜色显示严重性:
  • Blocker(阻碍)(红色)- 无障碍技术无法使用该元素。先修复此类问题。
  • Critical(关键)(黄色)- 该元素使用了已弃用的无障碍功能属性。
  • Major(重要)(蓝色)- 该元素缺少帮助用户理解或操作它的信息。
每个标记元素都有一个CodeLens批注显示问题数量及其严重性,例如A11y: 2 broken · 1 bad。批准包含Fix(修复)、Preview(预览)和Explain(解释)按钮。

扫描您的整个工作区

检查器会在您打开文件时对其进行检查。要同时检查工作区中的所有.tsx和.jsx文件,请执行以下操作:
  1. 打开命令面板。
  2. 运行A11y检查器: 运行Lint。
结果会显示在Vega Studio侧边栏的Accessibility(无障碍功能)视图中。

在侧边栏中查看问题

Accessibility(无障碍功能)视图列出了工作区中的所有无障碍功能问题。要将其打开,请从命令面板中运行A11y检查器: 显示侧边栏。 要更改问题的组织方式,请在视图的标题栏中选择Group by Severity(按严重性分组)或Group by File(按文件分组):
  • Group by Severity((按严重性分组))- 将Blocker(阻碍)、Critical(关键)和Major(重要)问题列在一起。
  • (按文件分组)(按文件分组)- 在问题出现的文件下列出问题。
Vega Studio侧边栏中的Accessibility(无障碍功能)视图,按严重性分组。Blocker(阻碍)组进行了扩展,列出了五个问题,包括角色值无效、switch元素缺失状态以及accessibilityDescribedBy引用损坏。 选择某个问题可在编辑器中转到对应位置。

了解问题

要查看问题摘要,请将鼠标悬停在带下划线的元素上。工具提示会显示规则名称、诊断消息、严重性以及文档链接。 有关更多详情,请在CodeLens批注中选择Explain(解释)。Explain(解释)面板显示:
  • 规则名称和严重性
  • 诊断消息
  • 有关如何解决问题的指南
  • 前后代码示例
  • 规则的禁止语法
  • 相关文档的链接
标记为Blocker(阻碍)的missing-accessible-label规则的Explain(解释)面板。它显示诊断消息、包含添加aria-label的前后代码示例的修复方法指导、使用eslint-disable-next-line注释的禁止方法示例,以及无障碍功能文档的链接。

修复问题

您可以一次修复一个问题,也可以一次性修复工作区中所有可修复的问题。

修复单个问题

  1. 选择问题旁边的灯泡图标,或在CodeLens批注中选择Fix(修复)。
  2. 选择要应用的修复方法。 检查器会应用修复,该元素的波浪下划线随即消失。
快速修复可以:
  • 添加缺失的aria-label。
  • 添加缺失的role。
  • 添加缺失的aria-checked或aria-selected状态。
  • 添加缺失的accessibilityHint。
  • 重命名已弃用的属性,例如将accessibilityLabel重命名为aria-label,或将accessibilityRole重命名为role。
  • 替换无效的角色值,例如将header替换为heading,或将image替换为img。

在应用修复之前进行预览

  1. 在CodeLens批注中选择Preview(预览)。 检查器会以内联方式显示建议的更改,并以绿色标注。 A11y检查器在编辑器中预览修复。TouchableOpacity元素带有下划线,建议的更改(添加aria-label="TODO")以内联方式用绿色显示。上方的CodeLens栏显示Accept Fix(接受修复)、Revert(恢复)、Fix(修复)、Preview(预览)和Explain(解释)。
  2. 要应用修复,请选择Accept Fix(接受修复);要丢弃修复,请选择“Revert(恢复)。

修复工作区中的所有问题

  1. 打开命令面板。
  2. 运行A11y检查器: 全部修复。 您还可以在Accessibility(无障碍功能)视图的标题栏中选择Fix All(全部修复)。
检查器会应用工作区中所有可用的快速修复。没有快速修复的问题会保留在问题视图中,供您手动修复。 当Accessibility(无障碍功能)视图未显示任何问题时,您的工作区将通过所有A11y检查器规则。 在提交更改之前,请先进行查看。

禁止问题

如果某个问题不适用于某个元素,则可以将其禁止。要添加禁止注释,请从灯泡菜单中选择禁止操作,或自行添加注释。 例如,要对一张装饰性图片禁止缺少标签规则:
检查器还能识别ESLint禁止注释。使用ESLint注释来抑制检查器和Vega ESLint插件中的问题:
不带规则名称的eslint-disable-next-line注释会禁止下一行的所有规则。

无障碍功能规则

在Vega ESLint插件中,阻碍规则默认为error,关键和重要规则默认为warn。

相关主题


最后修改于 2026年10月19日