Element : propriété ariaRequired
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é ariaRequired de l'interface Element reflète la valeur de l'attribut aria-required, qui indique que l'utilisateur·ice doit fournir une saisie sur l'élément avant qu'un formulaire puisse être envoyé.
Note :
[!NOTE]
Dans la mesure du possible, utilisez un élément HTML <input> avec type="text" ou un <textarea>, car ils 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 :
Exemples
Dans cet exemple, l'attribut aria-required sur l'élément avec un ID de boiteSaisieTexte est défini sur "true", indiquant que cette saisie doit être complétée. En utilisant ariaRequired, nous mettons à jour la valeur à "false".
<div id="etiquetteBoiteTexteMultiligne">
Entrez les étiquettes pour l'article
</div>
<div
role="textbox"
id="boiteSaisieTexte"
contenteditable="true"
aria-multiline="true"
aria-labelledby="etiquetteBoiteTexteMultiligne"
aria-required="true"></div>
let el = document.getElementById("boiteSaisieTexte");
console.log(el.ariaRequired); // "true"
el.ariaRequired = "false";
console.log(el.ariaRequired); // "false"
Spécifications
| Spécification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariarequired |