CKTIS / JavaScript
ARIA-live-regio’s: status, alert, aria-live en aria-atomic
ARIA-live-regio’s geven wijzigingen door aan hulptechnologie zonder de focus te verplaatsen. Kies de prioriteit van de aankondiging en hoeveel context erbij hoort.
Versie: 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;Met een ARIA-live-regio kan hulptechnologie zoals een schermlezer wijzigingen in de inhoud aankondigen zonder de focus te verplaatsen. Deze rollen en attributen horen bij het webplatform, niet bij ECMAScript. JavaScript werkt het DOM bij, bijvoorbeeld met textContent voor een bericht in platte tekst.
Gebruik role="status" voor niet-dringende informatie, zoals het aantal resultaten. Deze rol heeft impliciet aria-live="polite" en aria-atomic="true". De rol role="alert" heeft impliciet aria-live="assertive" en aria-atomic="true". Gebruik deze rol met mate, alleen voor dringende berichten die geen reactie vereisen. Voeg geen overbodig aria-live="assertive" toe aan een alert: sommige combinaties kunnen het bericht twee keer aankondigen.
aria-live bepaalt de prioriteit: polite wacht op een geschikt pauzemoment, assertive kan de huidige aankondiging onderbreken en off vraagt niet om een aankondiging als de focus buiten de regio ligt. Binnen de regio kunnen wijzigingen nog steeds worden aangekondigd. aria-atomic bepaalt de omvang, niet de prioriteit: true vraagt om de volledige inhoud van de regio, false alleen om de gewijzigde knooppunten. De algemene standaard is false, maar beide genoemde rollen hebben impliciet true.
Plaats een lege regio in het DOM voordat je de inhoud bijwerkt, bij voorkeur al in de oorspronkelijke HTML. Verplaats de focus er niet naartoe alleen om een wijziging aan te kondigen. Sommige combinaties kondigen ook een alert aan die met tekst en al wordt ingevoegd, maar vertrouw daar niet op. Test met de combinaties van browser en hulptechnologie die je ondersteunt.
Voorbeelden
<!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>Resultaat
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.
Sla het voorbeeld op als HTML-bestand en open het in een browser. Activeer ‘Add result’ twee keer en daarna ‘Simulate connection loss’. De tweede keer verandert alleen het getal, maar `status` vraagt om het hele bericht. De uitvoer is zichtbare paginatekst, geen gegarandeerde voorlezing.
Gerelateerde lessen
- JavaScript · Les 23 · Gemiddeld · Versie: 3