Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

aria-live — annoncer des changements de contenu

`aria-live` indique avec quelle urgence les technologies d’assistance doivent présenter les changements d’une région.

Version : WAI-ARIA 1.2

Syntaxe

<p aria-live="polite"></p>

Utilisez polite pour les mises à jour ordinaires, assertive avec parcimonie pour les messages urgents et off pour supprimer les annonces habituelles en arrière-plan. Cette dernière valeur ne garantit pas le silence lorsque le focus se trouve dans la région.

Créez la région avant d’actualiser son contenu. Ne déplacez pas inutilement le focus vers un message. L’urgence est une indication pour les technologies d’assistance, pas une garantie d’ordre ou de moment de parole ; le périmètre de l’annonce et le regroupement des changements sont distincts.

L’exemple actualise une région existante après activation de Save. Le test confirme Settings saved. et la sémantique live dans l’arbre d’accessibilité. Il ne simule pas de lecteur précis et ne promet donc pas une annonce identique dans toutes les configurations.

Exemples

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

Résultat

message=Settings saved.

Le changement de contenu et la sémantique de la région ont été vérifiés. L’ordre réel de parole nécessite un test distinct avec un lecteur d’écran.

Sources