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

Перечисление AccessibilityLiveRegion управляет озвучкой обновлений текста на Android. Значение пишут в параметре accessibilityLiveRegion у View или Text. Полезно для счётчиков и сообщений об ошибке.

Синтаксис

<Text accessibilityLiveRegion="polite">12345</Text>

Значения

Значение	Описание
`'none'`	Изменения текста не озвучиваются отдельно.
`'polite'`	Новый текст сообщают, когда закончится текущая фраза.
`'assertive'`	Новый текст сообщают сразу, прерывая текущую озвучку.

Значение по умолчанию: 'none'.

Пример

Давайте озвучим смену счётчика вежливо:

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

export default function App() {
	const [count, setCount] = useState(0);

	return (
		<View>
			<Text accessibilityLiveRegion="polite">{String(count)}</Text>
			<Button title="abcde" onPress={() => setCount(count + 1)} />
		</View>
	);
}

На экране число и кнопка. После нажатия чтение с экрана сообщит новое значение без резкого прерывания.

Пример

Давайте сразу озвучим важное предупреждение:

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

export default function App() {
	const [msg, setMsg] = useState('abcde');

	return (
		<View>
			<Text accessibilityLiveRegion="assertive">{msg}</Text>
			<Button
				title="12345"
				onPress={() => setMsg('12345')}
			/>
		</View>
	);
}

На экране подпись и кнопка. После смены текста на '12345' чтение с экрана прервёт текущую фразу.

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

метод announceForAccessibility,
который произносит фразу напрямую
перечисление AccessibilityRole,
которое задаёт роль элемента
перечисление ImportantForAccessibility,
которое скрывает или показывает элемент
компонент Text,
которому часто задают accessibilityLiveRegion