版本：Next

无障碍

Android 和 iOS 都提供了与辅助技术集成的 API，例如内置的屏幕阅读器 VoiceOver（iOS）和 TalkBack（Android）。React Native 提供了配套的 API，让你的应用能够适配所有用户。

信息

Android 和 iOS 的实现方式略有不同，因此 React Native 的实现可能会因平台而异。

无障碍属性

`accessible`

当为 true 时，表示该视图可被辅助技术发现，例如屏幕阅读器和硬件键盘。请注意，这并不一定意味着 VoiceOver 或 TalkBack 会聚焦该视图。出现这种情况有多种原因，例如 VoiceOver 不允许嵌套无障碍元素，或者 TalkBack 选择聚焦某个父元素。

默认情况下，所有可点击元素都是可访问的。

在 Android 上，accessible 会被转换为原生 focusable。在 iOS 上，它会被转换为原生 isAccessibilityElement。

React TSX
<View>
  <View accessible={true} />
  <View />
</View>

在上面的示例中，无障碍焦点仅可用于第一个带有 accessible 属性的子视图，而父视图或不带 accessible 的兄弟视图则不行。

`accessibilityLabel`

当一个视图被标记为可访问时，最好在该视图上设置 accessibilityLabel，这样使用 VoiceOver 或 TalkBack 的人就知道他们选中了什么元素。屏幕阅读器会在关联元素被选中时读出这个字符串。

使用时，请在你的 View、Text 或 Touchable 上将 accessibilityLabel 属性设置为自定义字符串：

React TSX
<TouchableOpacity
  accessible={true}
  accessibilityLabel="Tap me!"
  onPress={onPress}>
  <View style={styles.button}>
    <Text style={styles.buttonText}>Press me!</Text>
  </View>
</TouchableOpacity>

在上面的示例中，TouchableOpacity 元素上的 accessibilityLabel 默认会是 "Press me!"。该标签是通过将所有 Text 节点子元素用空格连接起来构造的。

`accessibilityLabelledBy`
Android

用于构建复杂表单时引用另一个元素的 nativeID。 accessibilityLabelledBy 的值应与相关元素的 nativeID 匹配：

React TSX
<View>
  <Text nativeID="formLabel">输入字段标签</Text>
  <TextInput
    accessibilityLabel="input"
    accessibilityLabelledBy="formLabel"
  />
</View>

在上面的示例中，屏幕阅读器在聚焦 TextInput 时会播报 Input, Edit Box for Label for Input Field。

`accessibilityHint`

当仅靠无障碍标签无法清楚表达操作结果时，可以使用无障碍提示向用户提供额外上下文。

请在你的 View、Text 或 Touchable 上将 accessibilityHint 属性设置为自定义字符串：

React TSX
<TouchableOpacity
  accessible={true}
  accessibilityLabel="返回"
  accessibilityHint="导航到上一屏幕"
  onPress={onPress}>
  <View style={styles.button}>
    <Text style={styles.buttonText}>返回</Text>
  </View>
</TouchableOpacity>

iOS

在上面的示例中，如果用户在设备的 VoiceOver 设置中启用了提示，VoiceOver 会在标签之后读出提示。有关 accessibilityHint 的指南，请参阅 iOS 开发者文档

Android

在上面的示例中，TalkBack 会在标签之后读出提示。目前，Android 上无法关闭提示。

`accessibilityLanguage`
iOS

通过使用 accessibilityLanguage 属性，屏幕阅读器将理解在朗读元素的标签、值和提示时应使用哪种语言。所提供的字符串值必须符合 BCP 47 规范。

React TSX
<View
  accessible={true}
  accessibilityLabel="Pizza"
  accessibilityLanguage="it-IT">
  <Text>🍕</Text>
</View>

`accessibilityIgnoresInvertColors`
iOS

反转屏幕颜色是 iOS 和 iPadOS 中提供的一项无障碍功能，适用于色盲、低视力或视力障碍人士。如果有某个视图在启用此设置时不希望被反转，例如照片，可以将此属性设为 true。

`accessibilityLiveRegion`
Android

当组件动态变化时，我们希望 TalkBack 提醒最终用户。这可以通过 accessibilityLiveRegion 属性实现。它可以设置为 none、polite 和 assertive：

none 无障碍服务不应播报对此视图的更改。
polite 无障碍服务应播报对此视图的更改。
assertive 无障碍服务应打断当前语音，立即播报对此视图的更改。

React TSX
<TouchableWithoutFeedback onPress={addOne}>
  <View style={styles.embedded}>
    <Text>Click me</Text>
  </View>
</TouchableWithoutFeedback>
<Text accessibilityLiveRegion="polite">
  Clicked {count} times
</Text>

在上面的示例中，方法 addOne 会更改状态变量 count。当触发 TouchableWithoutFeedback 时，TalkBack 会读取 Text 视图中的文本，因为它具有 accessibilityLiveRegion="polite" 属性。

`accessibilityRole`

accessibilityRole 向辅助技术用户传达组件的用途。

accessibilityRole 可以是以下值之一：

adjustable 用于元素可以被“调整”的场景（例如滑块）。
alert 用于元素包含需要呈现给用户的重要文本。
button 用于元素应被视为按钮。
checkbox 用于元素表示一个可勾选、可取消勾选或处于混合勾选状态的复选框。
combobox 用于元素表示一个组合框，允许用户从多个选项中选择。
header 用于元素充当内容区块的标题（例如导航栏标题）。
image 用于元素应被视为图像。可与按钮或链接组合使用。
imagebutton 用于元素应被视为按钮，同时也是图像。
keyboardkey 用于元素充当键盘按键。
link 用于元素应被视为链接。
menu 用于组件是一个选项菜单。
menubar 用于组件是多个菜单的容器。
menuitem 用于表示菜单中的一个项。
none 用于元素没有角色。
progressbar 用于表示一个指示任务进度的组件。
radio 用于表示单选按钮。
radiogroup 用于表示一组单选按钮。
scrollbar 用于表示滚动条。
search 用于文本字段元素也应被视为搜索字段。
spinbutton 用于表示一个会打开选项列表的按钮。
summary 用于应用首次启动时，元素可用于提供当前状态的快速摘要。
switch 用于表示可打开或关闭的开关。
tab 用于表示选项卡。
tablist 用于表示选项卡列表。
text 用于元素应被视为不可更改的静态文本。
timer 用于表示计时器。
togglebutton 用于表示切换按钮。应与 accessibilityState 的 checked 搭配使用，以指示按钮是否处于开启或关闭状态。
toolbar 用于表示工具栏（动作按钮或组件的容器）。
grid 与 ScrollView、VirtualizedList、FlatList 或 SectionList 一起使用时，用于表示网格。会向 Android 的 GridView 添加进入/离开网格的播报。

`accessibilityShowsLargeContentViewer`
iOS

一个布尔值，用于确定当用户在元素上执行长按时，是否显示大内容查看器。

适用于 iOS 13.0 及更高版本。

`accessibilityLargeContentTitle`
iOS

当显示大内容查看器时，将用作其标题的字符串。

需要将 accessibilityShowsLargeContentViewer 设置为 true。

React TSX
<View
  accessibilityShowsLargeContentViewer={true}
  accessibilityLargeContentTitle="Home Tab">
  <Text>主页</Text>
</View>

`accessibilityState`

向辅助技术用户描述组件的当前状态。

accessibilityState 是一个对象。它包含以下字段：

名称	描述	类型	必需
disabled	指示元素是否被禁用。	boolean	否
selected	指示一个可选择元素当前是否被选中。	boolean	否
checked	指示一个可勾选元素的状态。该字段可以是布尔值，也可以是表示混合复选框的 "mixed" 字符串。	boolean or 'mixed'	否
busy	指示元素当前是否处于繁忙状态。	boolean	否
expanded	指示一个可展开元素当前是展开还是折叠。	boolean	否

使用时，请将 accessibilityState 设置为具有特定定义的对象。

`accessibilityValue`

表示组件的当前值。它可以是组件值的文本描述；对于基于范围的组件，例如滑块和进度条，它包含范围信息（最小值、当前值和最大值）。

accessibilityValue 是一个对象。它包含以下字段：

名称	描述	类型	必需
min	该组件范围的最小值。	integer	如果设置了 `now`，则为必需。
max	该组件范围的最大值。	integer	如果设置了 `now`，则为必需。
now	该组件范围的当前值。	integer	否
text	该组件值的文本描述。如果设置，会覆盖 `min`、`now` 和 `max`。	string	否

`accessibilityViewIsModal`
iOS

一个布尔值，表示 VoiceOver 是否应忽略作为接收者兄弟视图中的元素。

例如，在包含兄弟视图 A 和 B 的窗口中，将视图 B 上的 accessibilityViewIsModal 设置为 true 会导致 VoiceOver 忽略视图 A 中的元素。另一方面，如果视图 B 包含子视图 C，并且你在视图 C 上将 accessibilityViewIsModal 设置为 true，VoiceOver 不会忽略视图 A 中的元素。

`accessibilityElementsHidden`
iOS

一个布尔值，表示给定的无障碍元素以及它包含的任何无障碍元素是否被隐藏。

例如，在包含兄弟视图 A 和 B 的窗口中，将视图 B 上的 accessibilityElementsHidden 设置为 true 会导致 VoiceOver 忽略 B 视图及其包含的任何元素。这与 Android 属性 importantForAccessibility="no-hide-descendants" 类似。

`aria-valuemax`

表示基于范围的组件的最大值，例如滑块和进度条。

`aria-valuemin`

表示基于范围的组件的最小值，例如滑块和进度条。

`aria-valuenow`

表示基于范围的组件的当前值，例如滑块和进度条。

`aria-valuetext`

表示该组件的文本描述。

`aria-busy`

指示某个元素正在被修改，辅助技术可能希望等到更改完成后再向用户告知更新。

类型	默认值
boolean	false

`aria-checked`

指示一个可勾选元素的状态。该字段可以是布尔值，也可以是表示混合复选框的 "mixed" 字符串。

类型	默认值
boolean, 'mixed'	false

`aria-disabled`

指示该元素可被感知到，但处于禁用状态，因此不可编辑或以其他方式操作。

类型	默认值
boolean	false

`aria-expanded`

指示一个可展开元素当前是展开还是折叠。

类型	默认值
boolean	false

`aria-hidden`

指示该元素是否对辅助技术隐藏。

例如，在包含兄弟视图 A 和 B 的窗口中，将视图 B 上的 aria-hidden 设置为 true 会导致 VoiceOver 忽略 B 元素及其子元素。

类型	默认值
boolean	false

`aria-label`

定义一个可用于为元素命名的字符串值。

类型
string

`aria-labelledby`
Android

标识用于为其所应用的元素命名的那个元素。aria-labelledby 的值应与相关元素的 nativeID 匹配：

React TSX
<View>
  <Text nativeID="formLabel">输入字段标签</Text>
  <TextInput aria-label="input" aria-labelledby="formLabel" />
</View>

类型
string

`aria-live`
Android

指示某个元素将被更新，并描述用户代理、辅助技术和用户可以对该实时区域预期的更新类型。

off 无障碍服务不应播报对此视图的更改。
polite 无障碍服务应播报对此视图的更改。
assertive 无障碍服务应打断当前语音，立即播报对此视图的更改。

类型	默认值
enum(`'assertive'`, `'off'`, `'polite'`)	`'off'`

`aria-modal`
iOS

布尔值，表示 VoiceOver 是否应忽略作为接收者兄弟视图中的元素。

类型	默认值
boolean	false

`aria-selected`

指示一个可选择元素当前是否被选中。

类型
boolean

`experimental_accessibilityOrder`

实验性 🧪

此 API 处于实验阶段。 实验性 API 可能包含错误，并且很可能在 React Native 的未来版本中发生变化。不要在生产环境中使用它们。

备注

为了简洁，以下示例中省略了布局，尽管布局决定了默认焦点顺序。请假设文档顺序与布局顺序一致。

experimental_accessibilityOrder 允许你定义辅助技术聚焦子组件的顺序。它是一个由设置在你所控制顺序的组件上的 nativeIDs 组成的数组。例如：

<View experimental_accessibilityOrder={['B', 'C', 'A']}>
  <View accessible={true} nativeID="A"/>
  <View accessible={true} nativeID="B"/>
  <View accessible={true} nativeID="C"/>
</View>

辅助技术将按 nativeID 为 B、然后 C、然后 A 的 View 进行聚焦。

experimental_accessibilityOrder 不会为其引用的组件“开启”无障碍功能，这仍然需要单独完成。因此，如果我们像下面这样移除上方 C 上的 accessible={true}：

<View experimental_accessibilityOrder={['B', 'C', 'A']}>
  <View accessible={true} nativeID="A"/>
  <View accessible={true} nativeID="B"/>
  <View nativeID="C"/>
</View>

那么新的顺序将是 B 然后 A，即使 C 仍然在 experimental_accessibilityOrder 中。

不过，experimental_accessibilityOrder 会“关闭”它未引用的组件的无障碍功能。

<View experimental_accessibilityOrder={['B', 'C', 'A']}>
  <View accessible={true} nativeID="A"/>
  <View accessible={true} nativeID="B"/>
  <View accessible={true} nativeID="C"/>
  <View accessible={true} nativeID="D"/>
</View>

上面示例的顺序将是 B、C、A。D 永远不会获得焦点。从这个意义上说，experimental_accessibilityOrder 是 穷尽式 的。

将一个非无障碍组件包含在 experimental_accessibilityOrder 中仍然有合理的原因。考虑：

<View experimental_accessibilityOrder={['B', 'C', 'A']}>
  <View accessible={true} nativeID="A"/>
  <View accessible={true} nativeID="B"/>
  <View nativeID="C">
    <View accessible={true} nativeID="D"/>
    <View accessible={true} nativeID="E"/>
    <View accessible={true} nativeID="F"/>
  </View>
</View>

焦点顺序将是 B、D、E、F、A。尽管 D、E 和 F 并没有被 experimental_accessibilityOrder 直接引用，但 C 被直接引用了。在这种情况下，C 是一个 无障碍容器——它包含可访问元素，但自身不可访问。如果一个无障碍容器被引用在 experimental_accessibilityOrder 中，那么它所包含元素的默认顺序将被应用。从这个意义上说，experimental_accessibilityOrder 是 可嵌套 的。

experimental_accessibilityOrder 也可以引用另一个带有 experimental_accessibilityOrder 的组件：

<View experimental_accessibilityOrder={['B', 'C', 'A']}>
  <View accessible={true} nativeID="A"/>
  <View accessible={true} nativeID="B"/>
  <View nativeID="C" experimental_accessibilityOrder={['F', 'E', 'D']}>
    <View accessible={true} nativeID="D"/>
    <View accessible={true} nativeID="E"/>
    <View accessible={true} nativeID="F"/>
  </View>
</View>

焦点顺序将是 B、F、E、D、A。

一个组件不能同时是无障碍容器和无障碍元素（accessible={true}）。因此，如果我们有：

<View experimental_accessibilityOrder={['B', 'C', 'A']}>
  <View accessible={true} nativeID="A"/>
  <View accessible={true} nativeID="B"/>
  <View accessible={true} nativeID="C" experimental_accessibilityOrder={['F', 'E', 'D']}>
    <View accessible={true} nativeID="D"/>
    <View accessible={true} nativeID="E"/>
    <View accessible={true} nativeID="F"/>
  </View>
</View>

焦点顺序将是 B、C、A。D、E 和 F 不再位于容器中，因此 experimental_accessibilityOrder 的穷尽性意味着它们将被排除。

`importantForAccessibility`
Android

对于两个具有相同父级且相互重叠的 UI 组件，默认的无障碍焦点行为可能不可预测。importantForAccessibility 属性通过控制视图是否触发无障碍事件以及是否向无障碍服务报告来解决这个问题。它可以设置为 auto、yes、no 和 no-hide-descendants（最后一个值会强制无障碍服务忽略该组件及其所有子组件）。

React TSX
<View style={styles.container}>
  <View
    style={[styles.layout, {backgroundColor: 'green'}]}
    importantForAccessibility="yes">
    <Text>第一个布局</Text>
  </View>
  <View
    style={[styles.layout, {backgroundColor: 'yellow'}]}
    importantForAccessibility="no-hide-descendants">
    <Text>第二个布局</Text>
  </View>
</View>

在上面的示例中，yellow 布局及其后代对 TalkBack 和所有其他辅助技术服务都是完全不可见的。因此，我们可以在不让 TalkBack 混淆的情况下使用具有相同父级的重叠视图。

`onAccessibilityEscape`
iOS

将此属性赋给一个自定义函数，当有人执行“escape”手势时会调用它，该手势是一个双指 Z 形手势。escape 函数应在用户界面中按层级返回。它可以表示在导航层级中向上或返回，或者关闭一个模态用户界面。如果所选元素没有 onAccessibilityEscape 函数，系统会尝试沿视图层级向上遍历，直到找到一个具有该函数的视图，或者发出提示音表示未能找到。

`onAccessibilityTap`
iOS

使用此属性为一个自定义函数赋值，当有人在选中一个可访问元素后双击它时，将调用该函数。

`onMagicTap`
iOS

将此属性赋给一个自定义函数，当有人执行“magic tap”手势时会调用它，该手势是双指双击。magic tap 函数应执行用户在某个组件上最可能采取的操作。在 iPhone 的电话应用中，magic tap 会接听电话或结束当前通话。如果所选元素没有 onMagicTap 函数，系统会沿视图层级向上遍历，直到找到一个具有该函数的视图。

`role`

role 用于传达组件的用途，并且优先于 accessibilityRole 属性。

role 可以是以下值之一：

alert 用于元素包含需要呈现给用户的重要文本。
button 用于元素应被视为按钮。
checkbox 用于元素表示一个可勾选、可取消勾选或处于混合勾选状态的复选框。
combobox 用于元素表示一个组合框，允许用户从多个选项中选择。
grid 与 ScrollView、VirtualizedList、FlatList 或 SectionList 一起使用时，用于表示网格。会向 android GridView 添加进入/离开网格的播报。
heading 用于元素充当内容区块的标题（例如导航栏标题）。
img 用于元素应被视为图像。可与按钮或链接组合使用，例如。
link 用于元素应被视为链接。
list 用于标识项目列表。
listitem 用于标识列表中的一项。
menu 用于组件是一个选项菜单。
menubar 用于组件是多个菜单的容器。
menuitem 用于表示菜单中的一个项。
none 用于元素没有角色。
presentation 用于元素没有角色。
progressbar 用于表示一个指示任务进度的组件。
radio 用于表示单选按钮。
radiogroup 用于表示一组单选按钮。
scrollbar 用于表示滚动条。
searchbox 用于文本字段元素也应被视为搜索字段。
slider 用于元素可以被“调整”的场景（例如滑块）。
spinbutton 用于表示一个会打开选项列表的按钮。
summary 用于应用首次启动时，元素可用于提供当前状态的快速摘要。
switch 用于表示可打开或关闭的开关。
tab 用于表示选项卡。
tablist 用于表示选项卡列表。
timer 用于表示计时器。
toolbar 用于表示工具栏（动作按钮或组件的容器）。

可访问性操作

可访问性操作允许辅助技术以编程方式调用组件的操作。要支持可访问性操作，组件必须做两件事：

通过 accessibilityActions 属性定义其支持的操作列表。
实现一个 onAccessibilityAction 函数来处理操作请求。

accessibilityActions 属性应包含一个操作对象列表。每个操作对象应包含以下字段：

名称	类型	必需
name	string	是
label	string	否

操作要么表示标准操作，例如点击按钮或调整滑块；要么表示特定于某个组件的自定义操作，例如删除电子邮件消息。name 字段对标准操作和自定义操作都必需，但对于标准操作，label 是可选的。

添加对标准操作的支持时，name 必须是以下之一：

'magicTap' - 仅限 iOS - 当 VoiceOver 焦点位于组件上或组件内部时，用户用两根手指双击。
'escape' - 仅限 iOS - 当 VoiceOver 焦点位于组件上或组件内部时，用户执行两指扫动手势（左、右、左）。
'activate' - 激活组件。这应当在有或没有辅助技术的情况下执行相同的操作。屏幕阅读器用户双击组件时会触发此操作。
'increment' - 增加一个可调节组件的值。在 iOS 上，当组件的角色为 'adjustable' 且用户将焦点置于其上并向上滑动时，VoiceOver 会生成此操作。在 Android 上，在 TalkBack 8.1 及更早版本中，当用户聚焦组件并按下音量增大按钮时会生成此操作。在 TalkBack 9.1 及更高版本中，这被“调整阅读控制”手势（在已聚焦的控件上向上滑动）所替代。
'decrement' - 减少一个可调节组件的值。在 iOS 上，当组件的角色为 'adjustable' 且用户将焦点置于其上并向下滑动时，VoiceOver 会生成此操作。在 Android 上，在 TalkBack 8.2 及更早版本中，当用户聚焦组件并按下音量减小按钮时会生成此操作。在 TalkBack 9.2 及更高版本中，这被“调整阅读控制”手势（在已聚焦的控件上向下滑动）所替代。
'longpress' - 仅限 Android - 当用户将辅助功能焦点置于组件上，然后用一根手指双击并按住屏幕时会生成此操作。这应当在有或没有辅助技术的情况下执行相同的操作。
'expand' - 仅限 Android - 此操作会“展开”组件，以便 TalkBack 播报“已展开”提示。
'collapse' - 仅限 Android - 此操作会“折叠”组件，以便 TalkBack 播报“已折叠”提示。

label 字段对标准操作是可选的，用于辅助技术描述某个操作的具体结果。例如，TalkBack 会使用此字段覆盖默认的“轻触两下以激活”提示，并显示诸如“轻触两下以打开聊天”之类的自定义说明。对于自定义操作，label 是一个本地化字符串，包含要呈现给用户的操作描述。

要处理操作请求，组件必须实现 onAccessibilityAction 函数。该函数的唯一参数是一个包含要执行操作名称的事件。下面来自 RNTester 的示例展示了如何创建一个定义并处理多个自定义操作的组件。

React TSX
<View
  accessible={true}
  accessibilityActions={[
    {name: 'cut', label: '剪切'},
    {name: 'copy', label: '复制'},
    {name: 'paste', label: '粘贴'},
  ]}
  onAccessibilityAction={event => {
    switch (event.nativeEvent.actionName) {
      case 'cut':
        Alert.alert('警告', '剪切操作成功');
        break;
      case 'copy':
        Alert.alert('警告', '复制操作成功');
        break;
      case 'paste':
        Alert.alert('警告', '粘贴操作成功');
        break;
    }
  }}
/>

检查屏幕阅读器是否已启用

AccessibilityInfo API 可让你确定屏幕阅读器当前是否处于活动状态。详情请参阅 AccessibilityInfo 文档。

发送可访问性事件
Android

有时，在 UI 组件上触发可访问性事件会很有用（例如，当自定义视图出现在屏幕上时，或将可访问性焦点设置到某个视图时）。原生 UIManager 模块为此提供了一个 sendAccessibilityEvent 方法。它接受两个参数：视图标签和事件类型。支持的事件类型有 typeWindowStateChanged、typeViewFocused 和 typeViewClicked。

React TSX
import {Platform, UIManager, findNodeHandle} from 'react-native';

if (Platform.OS === 'android') {
  UIManager.sendAccessibilityEvent(
    findNodeHandle(this),
    UIManager.AccessibilityEventTypes.typeViewFocused,
  );
}

测试 TalkBack 支持
Android

要启用 TalkBack，请在 Android 设备或模拟器上打开“设置”应用。点击“辅助功能”，然后点击 TalkBack。切换“使用服务”开关以启用或禁用它。

Android 模拟器默认未安装 TalkBack。你可以通过 Google Play 商店在模拟器上安装 TalkBack。请确保选择已安装 Google Play 商店的模拟器。这些模拟器可在 Android Studio 中获取。

你可以使用音量键快捷方式来切换 TalkBack。要开启音量键快捷方式，请进入“设置”应用，然后进入“辅助功能”。在顶部开启音量键快捷方式。

要使用音量键快捷方式，请同时按住两个音量键 3 秒以启动辅助工具。

此外，如果你愿意，也可以通过命令行切换 TalkBack：

# 禁用
adb shell settings put secure enabled_accessibility_services com.android.talkback/com.google.android.marvin.talkback.TalkBackService

# 启用
adb shell settings put secure enabled_accessibility_services com.google.android.marvin.talkback/com.google.android.marvin.talkback.TalkBackService

测试 VoiceOver 支持
iOS

要在 iOS 或 iPadOS 设备上启用 VoiceOver，请打开“设置”应用，点击“通用”，然后点击“辅助功能”。在这里你会找到许多可帮助用户让设备更易用的工具，其中包括 VoiceOver。要启用 VoiceOver，请在“视觉”下点击 VoiceOver，并切换顶部出现的开关。

在“辅助功能”设置的最底部，有一个“辅助功能快捷键”。你可以通过连按三次 Home 按钮来使用它切换 VoiceOver。

模拟器中无法使用 VoiceOver，但你可以使用 Xcode 中的 Accessibility Inspector，通过应用来使用 macOS 的 VoiceOver。请注意，最好始终使用真机测试，因为 macOS 的 VoiceOver 可能会带来不同的体验。

其他资源

让 React Native 应用具备可访问性

无障碍属性​

accessible​

accessibilityLabel​

accessibilityLabelledBy Android​

accessibilityHint​

accessibilityLanguage iOS​

accessibilityIgnoresInvertColors iOS​

accessibilityLiveRegion Android​

accessibilityRole​

accessibilityShowsLargeContentViewer iOS​

accessibilityLargeContentTitle iOS​

accessibilityState​

accessibilityValue​

accessibilityViewIsModal iOS​

accessibilityElementsHidden iOS​

aria-valuemax​

aria-valuemin​

aria-valuenow​

aria-valuetext​

aria-busy​

aria-checked​

aria-disabled​

aria-expanded​

aria-hidden​

aria-label​

aria-labelledby Android​

aria-live Android​

aria-modal iOS​

aria-selected​

experimental_accessibilityOrder​

importantForAccessibility Android​

onAccessibilityEscape iOS​

onAccessibilityTap iOS​

onMagicTap iOS​

role​

可访问性操作​

检查屏幕阅读器是否已启用​

发送可访问性事件 Android​

测试 TalkBack 支持 Android​

测试 VoiceOver 支持 iOS​

其他资源​