Перечисление AccessibilityRole

Перечисление AccessibilityRole задаёт роль элемента для VoiceOver и TalkBack. Значение пишут в параметре accessibilityRole у View и других компонентов с этим параметром. Полный каталог ролей длиннее: здесь перечислены частые варианты.

Синтаксис

<View accessibilityRole="button" />

Значения

Значение	Описание
`'none'`	Роль не задаётся, элемент не выделяется как типовой контрол.
`'button'`	Кнопка, на которую можно нажать.
`'link'`	Ссылка, которая открывает другое место или экран.
`'search'`	Поле или зона поиска.
`'image'`	Картинка или иконка без текста.
`'text'`	Статический текст.
`'header'`	Заголовок раздела экрана.
`'summary'`	Краткое описание блока, часто у сворачиваемого содержимого.
`'adjustable'`	Элемент, значение которого меняют жестом вверх и вниз.
`'switch'`	Переключатель вкл и выкл.

Пример

Давайте пометим нажимаемый блок как кнопку:

import { Pressable, Text } from 'react-native';

export default function App() {
	return (
		<Pressable accessibilityRole="button">
			<Text>abcde</Text>
		</Pressable>
	);
}

При чтении с экрана элемент озвучится как кнопка с текстом 'abcde'.

Пример

Давайте зададим заголовок и обычный текст:

import { View, Text } from 'react-native';

export default function App() {
	return (
		<View>
			<Text accessibilityRole="header">abcde</Text>
			<Text accessibilityRole="text">12345</Text>
		</View>
	);
}

На экране две строки. Чтение с экрана отделяет заголовок от основного текста.

Смотрите также

компонент View,
у которого задают accessibilityRole и accessibilityLabel
перечисление ImportantForAccessibility,
которое решает, попадает ли элемент в дерево доступности
перечисление AccessibilityLiveRegion,
которое задаёт озвучку изменений текста
класс AccessibilityInfo,
который проверяет, включено ли чтение с экрана