CKTIS / JavaScript
Živé oblasti ARIA: status, alert, aria-live a aria-atomic
Živé oblasti ARIA sprístupňujú zmeny obsahu asistenčným technológiám bez presunu fokusu. Určite prioritu oznámenia a to, koľko kontextu má obsahovať.
Verzia: Current web platform; runtime support varies
Syntax
// 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á oblasť ARIA umožňuje asistenčnej technológii, napríklad čítačke obrazovky, oznámiť zmenu obsahu bez presunu fokusu. Tieto roly a atribúty patria k webovej platforme, nie k ECMAScriptu. JavaScript aktualizuje DOM, napríklad pomocou textContent, ak je správa obyčajný text.
Použite role="status" pre informácie, ktoré nie sú naliehavé, napríklad počet výsledkov. Rola implicitne nastavuje aria-live="polite" a aria-atomic="true". Rola role="alert" implicitne nastavuje aria-live="assertive" a aria-atomic="true". Používajte ju striedmo, iba pre naliehavé správy, ktoré nevyžadujú odpoveď. Nepridávajte k nej nadbytočné aria-live="assertive": v niektorých konfiguráciách môže správa zaznieť dvakrát.
aria-live určuje prioritu: polite čaká na vhodnú prestávku, assertive môže prerušiť práve prebiehajúce oznámenie a off nežiada oznámenia, keď je fokus mimo oblasti. Ak je fokus v oblasti, zmeny sa stále môžu oznámiť. aria-atomic určuje rozsah, nie prioritu: true žiada celý obsah oblasti a false len zmenené uzly. Všeobecná predvolená hodnota je false, no obe uvedené roly implicitne používajú true.
Vložte prázdnu oblasť do DOM pred aktualizáciou obsahu, ideálne už v pôvodnom HTML. Nepresúvajte do nej fokus len preto, aby sa oznámila zmena. Niektoré konfigurácie oznámia aj upozornenie vložené rovno s textom, ale nespoliehajte sa na to. Otestujte podporované kombinácie prehliadača a asistenčnej technológie.
Prí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ýsledok
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 príklad ako súbor HTML a otvorte ho v prehliadači. Dvakrát aktivujte „Add result“ a potom „Simulate connection loss“. Druhýkrát sa zmení len číslo, ale `status` žiada oznámenie celej správy. Výstup je viditeľný text, nie zaručené prečítanie.
Súvisiace lekcie
- JavaScript · Lekcia 23 · Stredne pokročilá · Verzia: 3