AccessibilityInfo

有时，了解设备是否有当前处于活动状态的屏幕阅读器很有用。AccessibilityInfo API 就是为此目的而设计的。你可以使用它查询屏幕阅读器的当前状态，也可以注册监听器，以便在屏幕阅读器状态发生变化时收到通知。

示例

---

参考

方法

addEventListener()

React TSX

static addEventListener(
  eventName: AccessibilityChangeEventName | AccessibilityAnnouncementEventName,
  handler: (
    event: AccessibilityChangeEvent | AccessibilityAnnouncementFinishedEvent,
  ) => void,
): EmitterSubscription;

添加事件处理器。支持的事件：

事件名称	描述
accessibilityServiceChanged Android	当 TalkBack、其他 Android 辅助技术和第三方辅助功能服务等某些服务启用时触发。传递给事件处理器的参数是一个布尔值。当某个辅助功能服务启用时，该布尔值为 true，否则为 false。
announcementFinished iOS	当屏幕阅读器完成播报时触发。传递给事件处理器的参数是一个包含以下键的字典： announcement：屏幕阅读器播报的字符串。 success：一个布尔值，表示播报是否成功。
boldTextChanged iOS	当粗体文本开关的状态发生变化时触发。传递给事件处理器的参数是一个布尔值。当粗体文本启用时，该布尔值为 true，否则为 false。
grayscaleChanged iOS	当灰度开关的状态发生变化时触发。传递给事件处理器的参数是一个布尔值。当灰度启用时，该布尔值为 true，否则为 false。
invertColorsChanged iOS	当反转颜色开关的状态发生变化时触发。传递给事件处理器的参数是一个布尔值。当反转颜色启用时，该布尔值为 true，否则为 false。
reduceMotionChanged	当减少动态效果开关的状态发生变化时触发。传递给事件处理器的参数是一个布尔值。当减少动态效果启用时（或“开发者选项”中的“过渡动画缩放”设置为“动画关闭”时），该布尔值为 true，否则为 false。
reduceTransparencyChanged iOS	当降低透明度开关的状态发生变化时触发。传递给事件处理器的参数是一个布尔值。当降低透明度启用时，该布尔值为 true，否则为 false。
screenReaderChanged	当屏幕阅读器的状态发生变化时触发。传递给事件处理器的参数是一个布尔值。当屏幕阅读器启用时，该布尔值为 true，否则为 false。

---

announceForAccessibility()

React TSX

static announceForAccessibility(announcement: string);

发布一段由屏幕阅读器播报的字符串。

---

announceForAccessibilityWithOptions()

React TSX

static announceForAccessibilityWithOptions(
  announcement: string,
  options: {queue?: boolean},
);

发布一段由屏幕阅读器播报的字符串，并指定修改选项。默认情况下，播报会中断任何现有语音，但在 iOS 上，可以在选项对象中将 queue 设置为 true，使其排在现有语音之后。

参数：

名称	类型	描述
announcement Required	string	要播报的字符串
options Required	object	queue——将播报排在现有语音之后 iOS

---

getRecommendedTimeoutMillis()

Android

React TSX

static getRecommendedTimeoutMillis(originalTimeout: number): Promise<number>;

获取用户所需的超时时间（以毫秒为单位）。 此值在“辅助功能”设置中的“操作时间（辅助功能超时）”中设置。

参数：

名称	类型	描述
originalTimeout Required	number	如果未设置“辅助功能超时”，则返回的超时时间。请以毫秒为单位指定。

---

isAccessibilityServiceEnabled()

Android

React TSX

static isAccessibilityServiceEnabled(): Promise<boolean>;

检查是否启用了任何辅助功能服务。这包括 TalkBack，也包括可能已安装的任何第三方辅助功能应用。若只想检查 TalkBack 是否启用，请使用 isScreenReaderEnabled。返回一个解析为布尔值的 promise。当某个辅助功能服务启用时，结果为 true，否则为 false。

备注

如果只想检查 TalkBack 的状态，请使用 isScreenReaderEnabled。

---

isBoldTextEnabled()

iOS

React TSX

static isBoldTextEnabled(): Promise<boolean>:

查询粗体文本当前是否启用。返回一个解析为布尔值的 promise。当粗体文本启用时，结果为 true，否则为 false。

---

isGrayscaleEnabled()

iOS

React TSX

static isGrayscaleEnabled(): Promise<boolean>;

查询灰度当前是否启用。返回一个解析为布尔值的 promise。当灰度启用时，结果为 true，否则为 false。

---

isInvertColorsEnabled()

iOS

React TSX

static isInvertColorsEnabled(): Promise<boolean>;

查询反转颜色当前是否启用。返回一个解析为布尔值的 promise。当反转颜色启用时，结果为 true，否则为 false。

---

isReduceMotionEnabled()

React TSX

static isReduceMotionEnabled(): Promise<boolean>;

查询减少动态效果当前是否启用。返回一个解析为布尔值的 promise。当减少动态效果启用时，结果为 true，否则为 false。

---

isReduceTransparencyEnabled()

iOS

React TSX

static isReduceTransparencyEnabled(): Promise<boolean>;

查询降低透明度当前是否启用。返回一个解析为布尔值的 promise。当降低透明度启用时，结果为 true，否则为 false。

---

isScreenReaderEnabled()

React TSX

static isScreenReaderEnabled(): Promise<boolean>;

查询屏幕阅读器当前是否启用。返回一个解析为布尔值的 promise。当屏幕阅读器启用时，结果为 true，否则为 false。

---

isHighTextContrastEnabled()

Android

React TSX

static isHighTextContrastEnabled(): Promise<boolean>

查询高文本对比度当前是否启用。返回一个解析为布尔值的 promise。当高文本对比度启用时，结果为 true，否则为 false。

---

isDarkerSystemColorsEnabled()

iOS

React TSX

static isDarkerSystemColorsEnabled(): Promise<boolean>

查询深色系统颜色当前是否启用。返回一个解析为布尔值的 promise。当深色系统颜色启用时，结果为 true，否则为 false。

---

prefersCrossFadeTransitions()

iOS

React TSX

static prefersCrossFadeTransitions(): Promise<boolean>;

查询减少动态效果和偏好交叉淡化过渡设置当前是否启用。返回一个解析为布尔值的 promise。当偏好交叉淡化过渡启用时，结果为 true，否则为 false。

---

🗑️ setAccessibilityFocus()

Deprecated

建议改用带有 eventType focus 的 sendAccessibilityEvent。

React TSX

static setAccessibilityFocus(reactTag: number);

将辅助功能焦点设置到 React 组件。

在 Android 上，此方法会使用传入的 reactTag 和 UIManager.AccessibilityEventTypes.typeViewFocused 参数调用 UIManager.sendAccessibilityEvent 方法。

备注

请确保你希望接收辅助功能焦点的任何 View 都设置了 accessible={true}。

---

sendAccessibilityEvent()

React TSX

static sendAccessibilityEvent(host: HostInstance, eventType: AccessibilityEventTypes);

命令式地触发 React 组件上的辅助功能事件，例如更改屏幕阅读器的焦点元素。

备注

请确保你希望接收辅助功能焦点的任何 View 都设置了 accessible={true}。

名称	类型	描述
host Required	HostInstance	用于发送事件的组件 ref。
eventType Required	AccessibilityEventTypes	'click'（仅限 Android）、'focus'、'viewHoverEnter'（仅限 Android）或 'windowStateChange'（仅限 Android）之一