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é ariaDisabled

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é ariaDisabled de l'interface Element reflète la valeur de l'attribut aria-disabled, qui indique que l'élément est perceptible mais désactivé, donc il n'est pas modifiable ou autrement opérationnel.

Note : Dans la mesure du possible, utilisez l'élément HTML <input> avec type="button" ou l'élément <button> — car ces éléments ont une sémantique intégrée et ne nécessitent pas d'attributs ARIA.

Valeur

Une chaîne de caractères avec l'une des valeurs suivantes :

"true"

L'élément et tous ses descendants sélectionnables sont désactivés, mais perceptibles, et leurs valeurs ne peuvent pas être modifiées par l'utilisateur·ice.

"false"

L'élément est activé.

Exemples

Dans cet exemple, l'attribut aria-disabled sur l'élément avec un ID de sauvegarderModifications est défini sur "true", indiquant que cet input est actuellement désactivé. En utilisant ariaDisabled, nous mettons à jour la valeur à "false".

html
<div
  id="sauvegarderModifications"
  tabindex="0"
  role="button"
  aria-disabled="true">
  Sauvegarder
</div>
js
let el = document.getElementById("sauvegarderModifications");
console.log(el.ariaDisabled); // "true"
el.ariaDisabled = "false";
console.log(el.ariaDisabled); // "false"

Spécifications

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

Compatibilité des navigateurs