Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Element : propriété ariaDescription

Baseline 2024
Nouvellement disponible

Depuis March 2024, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

La propriété ariaDescription de l'interface Element reflète la valeur de l'attribut aria-description, qui définit une valeur de chaîne de caractères décrivant ou annotant l'élément actuel.

Valeur

Une chaîne de caractères.

Exemples

Dans cet exemple, l'attribut aria-description de l'élément avec un ID de bouton-fermer est défini sur la chaîne de caractères « Une description plus longue de la fonction de cet élément ». En utilisant ariaDescription, nous pouvons mettre à jour la valeur.

html
<button
  aria-label="Fermer"
  aria-description="Une description plus longue de la fonction de cet élément"
  id="bouton-fermer">
  X
</button>
js
let el = document.getElementById("bouton-fermer");
console.log(el.ariaDescription); // "Une description plus longue de la fonction de cet élément"
el.ariaDescription = "Une description différente";
console.log(el.ariaDescription); // "Une description différente"

Spécifications

Spécification
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariadescription

Compatibilité des navigateurs