Element : propriété ariaLive
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis octobre 2023.
La propriété ariaLive de l'interface Element reflète la valeur de l'attribut aria-live, qui indique qu'un élément est mis à jour et décrit les types de mises à jour que les agents utilisateurs, les technologies d'assistance et l'utilisateur·ice peuvent attendre de la région dynamique.
Valeur
Une chaîne de caractères contenant l'une des valeurs suivantes :
"assertive"-
Indique que les mises à jour de la région ont la plus haute priorité et doivent être présentées à l'utilisateur·ice immédiatement.
"off"-
Indique que les mises à jour de la région ne doivent pas être présentées à l'utilisateur·ice sauf si celui-ci est actuellement concentré sur cette région.
"polite"-
Indique que les mises à jour de la région doivent être présentées à la prochaine opportunité appropriée, par exemple à la fin de la lecture de la phrase en cours ou lorsque l'utilisateur·ice fait une pause dans la saisie.
Exemples
Dans cet exemple, l'attribut aria-live sur l'élément avec un ID de infoPlanete est défini sur "polite". Nous mettons ensuite à jour la valeur à "assertive".
<div role="region" id="infoPlanete" aria-live="polite">
<h2 id="titrePlanete">Aucune planète sélectionnée</h2>
<p id="descriptionPlanete">
Sélectionnez une planète pour voir sa description
</p>
</div>
let el = document.getElementById("infoPlanete");
console.log(el.ariaLive); // "polite"
el.ariaLive = "assertive";
console.log(el.ariaLive); // "assertive"
Spécifications
| Spécification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-arialive |