Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła