Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Živa područja ARIA: status, alert, aria-live i aria-atomic

Živa područja ARIA prenose promjene sadržaja asistivnoj tehnologiji bez premještanja fokusa. Odredite prioritet najave i koliko konteksta treba uključiti.

Verzija: Current web platform; runtime support varies

Sintaksa

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

Živo područje ARIA omogućuje asistivnoj tehnologiji, primjerice čitaču zaslona, da najavi promjenu sadržaja bez premještanja fokusa. Te uloge i atributi pripadaju web-platformi, a ne ECMAScriptu. JavaScript ažurira DOM, primjerice pomoću textContent ako je poruka običan tekst.

Upotrijebite role="status" za informacije koje nisu hitne, poput broja rezultata. Ta uloga podrazumijeva aria-live="polite" i aria-atomic="true". Uloga role="alert" podrazumijeva aria-live="assertive" i aria-atomic="true". Koristite je štedljivo, samo za hitne poruke koje ne traže odgovor. Ne dodajte suvišan aria-live="assertive" upozorenju: neke ga kombinacije mogu najaviti dvaput.

aria-live određuje prioritet: polite čeka prikladnu stanku, assertive može prekinuti trenutačnu najavu, a off ne traži najavu kada je fokus izvan područja. Dok je fokus unutar područja, promjene se i dalje mogu najaviti. aria-atomic određuje opseg, a ne prioritet: true traži sav sadržaj područja, a false samo promijenjene čvorove. Opća zadana vrijednost je false, ali obje navedene uloge podrazumijevaju true.

Umetnite prazno područje u DOM prije ažuriranja sadržaja, po mogućnosti već u početnom HTML-u. Nemojte premještati fokus u njega samo radi najave promjene. Neke kombinacije najavljuju i upozorenje umetnuto zajedno s tekstom, ali ne oslanjajte se na to. Provjerite podržane kombinacije preglednika i asistivne tehnologije.

Primjeri

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

Rezultat

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.

Spremite primjer kao HTML datoteku i otvorite je u pregledniku. Dvaput aktivirajte „Add result”, a zatim „Simulate connection loss”. Drugi se put mijenja samo broj, ali `status` traži najavu cijele poruke. Izlaz je vidljiv tekst na stranici, a ne zajamčeno čitanje.

Povezane lekcije

  • JavaScript · Lekcija 23 · Srednje · Verzija: 3

Izvori