CKTIS / HTML
aria-live — powiadomienia o zmianie treści
`aria-live` określa, jak pilnie technologie wspomagające powinny przedstawiać zmiany obszaru.
Wersja: WAI-ARIA 1.2
Składnia
<p aria-live="polite"></p>Używaj polite dla zwykłych aktualizacji, assertive oszczędnie dla pilnych komunikatów oraz off do wyłączenia typowych ogłoszeń w tle. Ostatnia wartość nie gwarantuje ciszy, gdy fokus znajduje się w obszarze.
Najpierw przygotuj region, następnie zmieniaj jego treść. Nie przenoś niepotrzebnie fokusu do komunikatu. Pilność jest wskazówką dla technologii wspomagających, nie gwarancją kolejki lub czasu mowy; zakres odczytu i grupowanie zmian to osobne kwestie.
Przykład aktualizuje istniejący region po kliknięciu Save. Test potwierdza tekst Settings saved. i właściwość live w drzewie dostępności. Nie symuluje konkretnego czytnika, więc nie obiecuje identycznego wypowiedzenia komunikatu w każdej konfiguracji.
Przykłady
<!doctype html><meta charset="utf-8">
<button id="save">Save</button><p id="status" aria-live="polite"></p>
<output id="result"></output>
<script>
document.querySelector('#save').addEventListener('click', () => { document.querySelector('#status').textContent = 'Settings saved.'; });
document.querySelector('#save').click();
document.querySelector('#result').textContent = 'message=' + document.querySelector('#status').textContent;
</script>Wynik
message=Settings saved.
Sprawdzono zmianę treści i semantykę regionu. Kolejność rzeczywistej mowy wymaga osobnego testu z czytnikiem.