Element : propriété ariaInvalid
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é ariaInvalid de l'interface Element reflète la valeur de l'attribut aria-invalid. Pertinent pour les rôles application, checkbox, combobox, gridcell, listbox, radiogroup, slider, spinbutton, textbox et tree, elle indique à l'API d'accessibilité si la valeur saisie ne correspond pas au format attendu par l'application.
Si l'attribut n'est pas présent, ou est défini sur une chaîne de caractères vide, la technologie d'assistance traite la valeur comme si elle était définie sur false. Si l'attribut est présent mais défini sur une valeur autre que false, grammar, spelling ou la chaîne de caractères vide (""), la technologie d'assistance traite la valeur comme true. La propriété reflète la valeur de l'attribut telle qu'elle est définie, et non telle qu'elle est traitée par la technologie d'assistance.
Valeur
Une chaîne de caractères avec l'une des valeurs suivantes :
"true"-
L'élément est invalide.
"false"(par défaut)-
L'élément n'est pas dans un état invalide.
"grammar"-
L'élément est dans un état invalide en raison d'une erreur grammaticale détectée.
"spelling"-
L'élément est dans un état invalide en raison d'une erreur d'orthographe détectée.
Exemples
Dans cet exemple, l'attribut aria-invalid sur l'élément avec un ID de citation est omis, renvoyant null et traité comme false. En utilisant ariaInvalid, nous mettons à jour la valeur à grammar (car il y a deux erreurs).
<div id="citation" role="textbox" contenteditable>
vous êtes ce qu'il y a de mieux chez vous…
</div>
const el = document.getElementById("citation");
journaliser(`Valeur initiale : ${el.ariaInvalid}`);
el.ariaInvalid = "grammar";
journaliser(`Valeur mise à jour : ${el.ariaInvalid}`);
Spécifications
| Spécification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariainvalid |
Compatibilité des navigateurs
Voir aussi
- La propriété
Element.ariaRequired - L'attribut ARIA
aria-required - L'attribut ARIA
aria-errormessage - La propriété
Element.ariaErrorMessageElements