Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Živé oblasti ARIA: status, alert, aria-live a aria-atomic

Živé oblasti ARIA předávají změny obsahu asistivním technologiím bez přesunu fokusu. Nastavte prioritu oznámení a určete, kolik kontextu má obsahovat.

Verze: Current web platform; runtime support varies

Syntaxe

// 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;

Živá oblast ARIA umožňuje asistivní technologii, například čtečce obrazovky, oznámit změnu obsahu bez přesunu fokusu. Tyto role a atributy patří k webové platformě, nikoli k ECMAScriptu. JavaScript aktualizuje DOM, například pomocí textContent, pokud je zpráva prostý text.

Použijte role="status" pro informace, které nespěchají, například počet výsledků. Role implicitně nastavuje aria-live="polite" a aria-atomic="true". Role role="alert" implicitně nastavuje aria-live="assertive" a aria-atomic="true". Používejte ji střídmě, jen pro naléhavé zprávy, které nevyžadují odpověď. Nepřidávejte k ní nadbytečné aria-live="assertive": v některých konfiguracích může zpráva zaznít dvakrát.

aria-live určuje prioritu: polite čeká na vhodnou pauzu, assertive může přerušit aktuální oznámení a off nepožaduje oznámení, když je fokus mimo oblast. Pokud je fokus uvnitř oblasti, změny mohou být stále oznámeny. aria-atomic určuje rozsah, ne prioritu: true požaduje celý obsah oblasti, false jen změněné uzly. Obecná výchozí hodnota je false, ale obě uvedené role implicitně používají true.

Vložte prázdnou oblast do DOM před aktualizací obsahu, nejlépe už v počátečním HTML. Nepřesouvejte do ní fokus jen kvůli oznámení změny. Některé konfigurace oznámí i upozornění vložené rovnou s textem, ale nespoléhejte na to. Testujte podporované kombinace prohlížeče a asistivní technologie.

Příklady

<!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>

Výsledek

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.

Uložte příklad jako soubor HTML a otevřete ho v prohlížeči. Dvakrát aktivujte „Add result“ a potom „Simulate connection loss“. Při druhé aktivaci se změní jen číslo, ale `status` požaduje oznámení celé zprávy. Výstup je viditelný text, nikoli zaručené přečtení.

Související lekce

  • JavaScript · Lekce 23 · Středně pokročilá · Verze: 3

Zdroje