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