WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

aria-busy — eine Aktualisierung dauert noch an

`aria-busy="true"` informiert Hilfstechnologien, dass Änderungen einer Region noch unvollständig sind und später präsentiert werden können.

Version: WAI-ARIA 1.2

Syntax

<div aria-live="polite" aria-busy="true">Updating…</div>

Setze vor mehreren Änderungen die Zeichenfolge true und anschließend false. Standard ist false. Ein Screenreader kann Änderungen zurückhalten und die abgeschlossene Aktualisierung als Einheit behandeln. Ein genauer Sprechzeitpunkt wird nicht garantiert.

Das Attribut sperrt keine Klicks, deaktiviert keine Buttons, startet keinen Abruf und zeichnet keinen Fortschrittsbalken. Dafür braucht es Anwendungslogik und sichtbare Rückmeldung. Lass die Region nach einem Fehler nicht dauerhaft beschäftigt: Setze bei asynchronem Code den Zustand in finally zurück und zeige den Fehler.

Das Beispiel protokolliert false → true → false beim Ändern einer Zahl. Der Button bleibt aktiv und zeigt damit die Grenze von ARIA. Beim Umbau eines Widgets, das vorübergehend erforderliche eigene Elemente verliert, kennzeichnet der Zustand diese Zwischenphase.

Beispiele

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

Ergebnis

false -> true -> false; region=3 items; buttonDisabled=false

Geprüft werden Zustandsreihenfolge, Endinhalt und fehlende automatische Button-Deaktivierung, nicht die Sprachwarteschlange eines Screenreaders.

Quellen