Element : propriété ariaLabel
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é ariaLabel de l'interface Element reflète la valeur de l'attribut aria-label, qui définit une chaîne de caractères étiquetant l'élément actuel.
Valeur
Une chaîne de caractères ou null.
Exemples
Dans cet exemple, l'attribut aria-label sur l'élément avec un ID de bouton-fermer est défini sur « Fermer ». En utilisant ariaLabel, nous mettons à jour la valeur à « Fermer la boîte de dialogue ».
html
<button aria-label="Fermer" id="bouton-fermer">X</button>
js
let el = document.getElementById("bouton-fermer");
console.log(el.ariaLabel); // "Fermer"
el.ariaLabel = "Fermer la boîte de dialogue";
console.log(el.ariaLabel); // "Fermer la boîte de dialogue"
Spécifications
| Spécification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-arialabel |