CKTIS / HTML
aria-busy — aktualizacja jeszcze trwa
Stan `aria-busy="true"` informuje technologie wspomagające, że zmiany regionu są jeszcze niekompletne i mogą zostać przedstawione później.
Wersja: WAI-ARIA 1.2
Składnia
<div aria-live="polite" aria-busy="true">Updating…</div>Ustaw tekstowe true przed serią zmian, a false po ich zakończeniu. Domyślnym stanem jest false. Czytnik może odłożyć przedstawienie zmian i potraktować zakończoną aktualizację jako całość. Nie jest to gwarancja dokładnego momentu wypowiedzi.
Atrybut nie blokuje kliknięć, nie wyłącza przycisków, nie uruchamia pobierania ani nie rysuje wskaźnika postępu. Te działania wymagają własnej logiki i widocznej informacji. Nie pozostawiaj regionu stale zajętego po błędzie; dla kodu asynchronicznego przywróć stan w finally, a błąd przedstaw użytkownikowi.
Przykład zapisuje przejścia false → true → false podczas zmiany liczby. Przycisk pozostaje włączony, co pokazuje granicę semantyki ARIA. Przy przebudowie widgetu, który przejściowo traci wymagane elementy potomne, stan zajętości pozwala oznaczyć ten okres.
Przykłady
<!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>Wynik
false -> true -> false; region=3 items; buttonDisabled=false
Sprawdzono kolejność stanów, końcową treść i brak automatycznego wyłączenia przycisku. Test nie mierzy kolejki wypowiedzi czytnika.