Element : propriété ariaChecked
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é ariaChecked de l'interface Element reflète la valeur de l'attribut aria-checked, qui indique l'état actuel « coché » des cases à cocher, des boutons radio et d'autres composants qui ont un état coché.
Note :
Dans la mesure du possible, utilisez un élément HTML <input> avec type="checkbox", car cet élément possède une sémantique intégrée et ne nécessite pas d'attributs ARIA.
Valeur
Une chaîne de caractères avec l'une des valeurs suivantes :
"true"-
L'élément est coché.
"mixed"-
Indique une valeur mixte pour une case à cocher ou un élément de menu à trois états.
"false"-
L'élément peut être coché mais n'est pas actuellement coché.
"undefined"-
L'élément ne peut pas être coché.
Exemples
Dans cet exemple, l'attribut aria-checked de l'élément avec un ID de checkBoxInput est défini sur "false", indiquant que cette entrée n'est actuellement pas cochée. En utilisant ariaChecked, nous mettons à jour la valeur à "true".
<span
role="checkbox"
id="checkBoxInput"
aria-checked="false"
tabindex="0"
aria-labelledby="chk1-label">
</span>
<label id="chk1-label">Se souvenir de mes préférences</label>
let el = document.getElementById("checkBoxInput");
console.log(el.ariaChecked); // "false"
el.ariaChecked = "true";
console.log(el.ariaChecked); // "true"
Spécifications
| Spécification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariachecked |