AccessibilityInfo

Иногда полезно знать, есть ли на устройстве экранный ридер, который в данный момент активен. API AccessibilityInfo предназначен для этой цели. Вы можете использовать его для запроса текущего состояния экранного ридера, а также для регистрации уведомлений о изменении состояния экранного ридера.

Компонент функции
Компонент класса

Справочник

Методы

`addEventListener()`

static addEventListener(eventName, handler)

Добавить обработчик событий. Поддерживаемые события:

Имя события	Описание
`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()`

static announceForAccessibility(announcement)

Опубликовать строку, которая должна быть объявлена экранным ридером.

`announceForAccessibilityWithOptions()`

static announceForAccessibilityWithOptions(announcement, options)

Опубликовать строку, которая должна быть объявлена экранным ридером с опциями изменения. По умолчанию объявления будут прерывать любой существующий текст, но на iOS они могут быть помещены в очередь за существующим текстом, установив queue на true в объекте опций.

Параметры:

Имя	Тип	Описание
объявление Обязательно	строка	Строка, которая должна быть объявлена
опции Обязательно	объект	`queue` - поместить объявление в очередь за существующим текстом iOS

`getRecommendedTimeoutMillis()`
Android

static getRecommendedTimeoutMillis(originalTimeout)

Получить время ожидания в миллисекундах, необходимое пользователю.
Это значение задаётся в "Время для выполнения действия (Время ожидания доступности)" в настройках "Доступность".

Параметры:

Имя	Тип	Описание
originalTimeout Обязательно	число	Время ожидания, которое нужно вернуть, если "Время ожидания доступности" не задано. Укажите в миллисекундах.

`isAccessibilityServiceEnabled()`
Android

static isAccessibilityServiceEnabled(): Promise<boolean>

Проверить, включена ли какая-либо служба доступности. Это включает TalkBack, а также любое стороннее приложение доступности, которое может быть установлено. Чтобы проверить только включен ли TalkBack, используйте isScreenReaderEnabled. Возвращает промис, который разрешается булевым значением. Результат равен true когда включены некоторые службы доступности и false в противном случае.

Примечание: Используйте isScreenReaderEnabled, если вы хотите проверить только состояние TalkBack.

`isBoldTextEnabled()`
iOS

static isBoldTextEnabled()

Запросить, включен ли в данный момент жирный текст. Возвращает промис, который разрешается булевым значением. Результат равен true при включенном жирном тексте и false в противном случае.

`isGrayscaleEnabled()`
iOS

static isGrayscaleEnabled()

Запросить, включен ли в данный момент сероватый масштаб. Возвращает промис, который разрешается булевым значением. Результат равен true при включенном сероватом масштабе и false в противном случае.

`isInvertColorsEnabled()`
iOS

static isInvertColorsEnabled()

Запросить, включено ли в данный момент инвертирование цветов. Возвращает промис, который разрешается булевым значением. Результат равен true при включённом инвертировании цветов и false в противном случае.

`isReduceMotionEnabled()`

static isReduceMotionEnabled()

Запросить, включено ли в данный момент уменьшение движения. Возвращает промис, который разрешается булевым значением. Результат равен true при включенном уменьшении движения и false в противном случае.

`isReduceTransparencyEnabled()`
iOS

static isReduceTransparencyEnabled()

Запросить, включена ли в данный момент уменьшенная прозрачность. Возвращает промис, который разрешается булевым значением. Результат равен true при включённой уменьшенной прозрачности и false в противном случае.

`isScreenReaderEnabled()`

static isScreenReaderEnabled()

Запросить, включен ли в данный момент экранный ридер. Возвращает промис, который разрешается булевым значением. Результат равен true при включённом экранном ридере и false в противном случае.

`removeEventListener()`

static removeEventListener(eventName, handler)

Устарело. Используйте метод remove() на подписке на событие, возвращенной addEventListener().

`setAccessibilityFocus()`

static setAccessibilityFocus(reactTag)

Установить фокус доступности для компонента React.

В Android это вызывает метод UIManager.sendAccessibilityEvent с переданными reactTag и UIManager.AccessibilityEventTypes.typeViewFocused аргументами.

Примечание: Убедитесь, что любой View , который вы хотите получить фокус доступности, имеет accessible={true}.

© 2022 Facebook Inc.
Licensed under the Creative Commons Attribution 4.0 International Public License.
https://reactnative.dev/docs/accessibilityinfo

AccessibilityInfo

Справочник

Методы

addEventListener()

announceForAccessibility()

announceForAccessibilityWithOptions()

getRecommendedTimeoutMillis() Android

isAccessibilityServiceEnabled() Android

isBoldTextEnabled() iOS

isGrayscaleEnabled() iOS

isInvertColorsEnabled() iOS

isReduceMotionEnabled()

isReduceTransparencyEnabled() iOS

isScreenReaderEnabled()

removeEventListener()

setAccessibilityFocus()