CKTIS / HTML
aria-busy — een update is nog niet klaar
`aria-busy="true"` meldt aan hulptechnologie dat wijzigingen van een regio onvolledig zijn en later kunnen worden gepresenteerd.
Versie: WAI-ARIA 1.2
Syntax
<div aria-live="polite" aria-busy="true">Updating…</div>Zet de tekenreeks true vóór meerdere wijzigingen en false erna. De standaard is false. Een schermlezer kan wijzigingen uitstellen en de voltooide update als één geheel behandelen. Een exact spreektijdstip is niet gegarandeerd.
Het attribuut blokkeert geen klikken, schakelt geen knoppen uit, start geen ophalen en tekent geen voortgang. Dat vereist eigen logica en zichtbare feedback. Laat een regio niet bezet na een fout: herstel bij asynchrone code de toestand in finally en meld de fout.
Het voorbeeld registreert false → true → false tijdens een tellerupdate. De knop blijft actief en toont daarmee de grens van ARIA. Wanneer een widget tijdelijk vereiste eigen elementen verliest tijdens herbouw, kan de bezettoestand die periode markeren.
Voorbeelden
<!doctype html><meta charset="utf-8">
<div id="status" aria-live="polite" aria-busy="false"><span>0</span> items</div>
<button id="control">Available action</button><output id="result"></output>
<script>
const status = document.querySelector('#status');
const states = [status.getAttribute('aria-busy')];
status.setAttribute('aria-busy', 'true');
states.push(status.getAttribute('aria-busy'));
try {
status.querySelector('span').textContent = '3';
} finally {
status.setAttribute('aria-busy', 'false');
states.push(status.getAttribute('aria-busy'));
}
document.querySelector('#result').textContent =
states.join(' -> ') + '; region=' + status.textContent +
'; buttonDisabled=' + document.querySelector('button').disabled;
</script>Resultaat
false -> true -> false; region=3 items; buttonDisabled=false
De test controleert toestandsvolgorde, eindinhoud en ontbreken van automatische knopuitschakeling, niet de spraakwachtrij.