CKTIS / JavaScript
Regiony aktywne ARIA: status, alert, aria-live i aria-atomic
Regiony aktywne ARIA udostępniają zmiany treści technologiom asystującym bez przenoszenia fokusu. Wybierz priorytet komunikatu i zdecyduj, ile kontekstu przekazać.
Wersja: Current web platform; runtime support varies
Składnia
// Live-region roles and attributes are defined by WAI-ARIA 1.2.
role="status" (implicit aria-live="polite", aria-atomic="true")
role="alert" (implicit aria-live="assertive", aria-atomic="true")
aria-live="off" | "polite" | "assertive"
aria-atomic="false" | "true"
// DOM update: change the text of a node in an existing live region.
messageNode.textContent = message;Region aktywny ARIA pozwala technologii asystującej, np. czytnikowi ekranu, ogłosić zmianę treści bez przenoszenia fokusu. Role i atrybuty należą do platformy internetowej, a nie do ECMAScript. JavaScript aktualizuje DOM, np. przez textContent, gdy komunikat ma być zwykłym tekstem.
Używaj role="status" do niepilnych informacji, takich jak liczba wyników. Rola ta domyślnie ustawia aria-live="polite" oraz aria-atomic="true". Rola role="alert" domyślnie ustawia aria-live="assertive" oraz aria-atomic="true". Stosuj ją oszczędnie, tylko do pilnych komunikatów, które nie wymagają odpowiedzi. Nie dodawaj do niej zbędnego aria-live="assertive": w niektórych konfiguracjach może to spowodować dwukrotne odczytanie komunikatu.
aria-live określa priorytet: polite czeka na dogodny moment, assertive może przerwać bieżący odczyt, a off nie prosi o ogłaszanie zmian poza fokusem. Gdy fokus jest w regionie, zmiany nadal mogą być ogłaszane. aria-atomic określa zakres, nie priorytet: true prosi o przekazanie całej zawartości regionu, a false tylko zmienionych węzłów. Ogólna wartość domyślna to false, ale obie opisane role mają domyślnie true.
Umieść pusty region w DOM przed aktualizacją jego treści, najlepiej już w początkowym HTML. Nie przenoś do niego fokusu tylko po to, by ogłosić zmianę. Niektóre konfiguracje ogłaszają także alert wstawiony od razu z treścią, ale nie polegaj na tym. Sprawdź działanie w obsługiwanych kombinacjach przeglądarki i technologii asystującej.
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>ARIA live regions</title>
</head>
<body>
<button type="button" id="add-result">Add result</button>
<button type="button" id="simulate-failure">Simulate connection loss</button>
<p id="result-status" role="status"></p>
<p id="connection-alert" role="alert"></p>
<script>
const statusRegion = document.getElementById('result-status');
const alertRegion = document.getElementById('connection-alert');
const count = document.createElement('span');
let total = 0;
document.getElementById('add-result').addEventListener('click', () => {
if (total === 0) statusRegion.append('Results: ', count);
total += 1;
count.textContent = String(total);
});
document.getElementById('simulate-failure').addEventListener('click', () => {
alertRegion.textContent = 'Connection lost. Changes cannot be saved.';
});
</script>
</body>
</html>Wynik
Initially both regions are empty. After the first activation of Add result: Results: 1 After the second activation of Add result: Results: 2 After activating Simulate connection loss: Connection lost. Changes cannot be saved. These are visible text updates, not a screen reader transcript.
Zapisz przykład jako plik HTML i otwórz go w przeglądarce. Aktywuj „Add result” dwa razy, a następnie „Simulate connection loss”. Za drugim razem zmienia się tylko liczba, ale `status` prosi o ogłoszenie całego komunikatu. Wynik pokazuje tekst widoczny na stronie, a nie gwarantowany odczyt.
Powiązane lekcje
- JavaScript · Lekcja 23 · Średniozaawansowany · Wersja: 3