Element : propriété ariaRelevant
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.
Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.
La propriété ariaRelevant de l'interface Element reflète la valeur de l'attribut aria-relevant, qui indique quelles notifications l'agent utilisateur déclenche lorsque l'arbre d'accessibilité à l'intérieur d'une région active est modifié. Cela permet de décrire quels changements dans une région aria-live sont pertinents et doivent être annoncés.
Valeur
Une chaîne de caractères contenant une ou plusieurs des valeurs suivantes, séparées par des espaces :
"additions"-
Ajouts de nœuds d'élément dans la région active doivent être considérés comme pertinents.
"removals"-
Suppression de nœuds de la région active doit être considérée comme pertinente.
"text"-
Modifications du contenu textuel des nœuds existants doivent être considérées comme pertinentes.
"all"-
Équivalent à
"additions removals text".
Exemples
Dans cet exemple, l'attribut aria-relevant sur l'élément avec un ID de horloge est défini sur "all". En utilisant ariaRelevant, nous mettons à jour la valeur à "text".
<div
id="horloge"
role="timer"
aria-live="polite"
aria-atomic="true"
aria-relevant="all"></div>
let el = document.getElementById("horloge");
console.log(el.ariaRelevant); // all
el.ariaRelevant = "text";
console.log(el.ariaRelevant); // text