Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła