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

CKTIS / JavaScript

Régions dynamiques ARIA : status, alert, aria-live et aria-atomic

Les régions dynamiques ARIA transmettent les changements aux technologies d’assistance sans déplacer le focus. Choisissez la priorité de l’annonce et le contexte à restituer.

Version : Current web platform; runtime support varies

Syntaxe

// Live-region roles and attributes are defined by WAI-ARIA 1.2.
role="status"  (implicit aria-live="polite", aria-atomic="true")
role="alert"   (implicit aria-live="assertive", aria-atomic="true")
aria-live="off" | "polite" | "assertive"
aria-atomic="false" | "true"

// DOM update: change the text of a node in an existing live region.
messageNode.textContent = message;

Une région dynamique ARIA permet à une technologie d’assistance, comme un lecteur d’écran, d’annoncer un changement de contenu sans déplacer le focus. Ces rôles et attributs relèvent de la plateforme web, pas d’ECMAScript. JavaScript met à jour le DOM, par exemple avec textContent pour un message en texte brut.

Utilisez role="status" pour une information non urgente, comme le nombre de résultats. Ce rôle implique aria-live="polite" et aria-atomic="true". Le rôle role="alert" implique aria-live="assertive" et aria-atomic="true". Réservez-le aux messages urgents qui n’exigent pas de réponse. N’ajoutez pas un aria-live="assertive" redondant à une alerte : certaines configurations peuvent l’annoncer deux fois.

aria-live règle la priorité : polite attend une pause appropriée, assertive peut interrompre l’annonce en cours et off ne demande pas d’annonce si le focus est hors de la région. Les changements peuvent encore être annoncés si le focus est dans la région. aria-atomic règle la portée, pas la priorité : true demande le contenu entier de la région, false seulement les nœuds modifiés. La valeur générale par défaut est false, mais les deux rôles ci-dessus impliquent true.

Placez une région vide dans le DOM avant de modifier son contenu, de préférence dès le HTML initial. N’y déplacez pas le focus uniquement pour faire annoncer un changement. Certaines configurations annoncent aussi une alerte insérée avec son texte, mais ne comptez pas dessus. Testez les combinaisons de navigateurs et de technologies d’assistance que vous prenez en charge.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ARIA live regions</title>
</head>
<body>
  <button type="button" id="add-result">Add result</button>
  <button type="button" id="simulate-failure">Simulate connection loss</button>
  <p id="result-status" role="status"></p>
  <p id="connection-alert" role="alert"></p>

  <script>
    const statusRegion = document.getElementById('result-status');
    const alertRegion = document.getElementById('connection-alert');
    const count = document.createElement('span');
    let total = 0;

    document.getElementById('add-result').addEventListener('click', () => {
      if (total === 0) statusRegion.append('Results: ', count);
      total += 1;
      count.textContent = String(total);
    });

    document.getElementById('simulate-failure').addEventListener('click', () => {
      alertRegion.textContent = 'Connection lost. Changes cannot be saved.';
    });
  </script>
</body>
</html>

Résultat

Initially both regions are empty.
After the first activation of Add result: Results: 1
After the second activation of Add result: Results: 2
After activating Simulate connection loss: Connection lost. Changes cannot be saved.
These are visible text updates, not a screen reader transcript.

Enregistrez l’exemple dans un fichier HTML et ouvrez-le dans un navigateur. Activez deux fois « Add result », puis « Simulate connection loss ». À la deuxième activation, seul le nombre change, mais `status` demande l’annonce du message entier. Le résultat indique le texte visible, pas une annonce garantie.

Leçons associées

  • JavaScript · Leçon 23 · Intermédiaire · Version : 3

Sources