CKTIS / HTML
aria-live — annunciare contenuti modificati
`aria-live` indica con quale urgenza le tecnologie assistive devono presentare le modifiche di una regione.
Versione: WAI-ARIA 1.2
Sintassi
<p aria-live="polite"></p>Usa polite per aggiornamenti ordinari, assertive con moderazione per messaggi urgenti e off per sopprimere gli annunci abituali in sottofondo. Quest’ultimo valore non garantisce silenzio quando il focus è nella regione.
Predisponi la regione prima di aggiornarne i contenuti. Non spostare inutilmente il focus sul messaggio. L’urgenza è un’indicazione per le tecnologie assistive, non una garanzia sull’ordine o sui tempi della voce; ambito dell’annuncio e raggruppamento delle modifiche sono aspetti separati.
L’esempio aggiorna una regione esistente dopo l’attivazione di Save. Il test conferma Settings saved. e la semantica live nell’albero di accessibilità. Non simula un lettore specifico, quindi non promette un annuncio identico in ogni configurazione.
Esempi
<!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>Risultato
message=Settings saved.
Verificati i contenuti modificati e la semantica della regione. L’ordine effettivo della voce richiede una prova separata con un lettore di schermo.