Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
ARIA : attribut aria-checked
L'attributaria-checked indique l'état actuel (« sélectionné » ou non) des cases à cocher, boutons radio et autres widgets.
Note :Dans la mesure du possible, utilisez un élément HTML<input> avectype="checkbox" outype="radio" : ces éléments possèdent une sémantique intégrée et ne nécessitent pas d'attributs ARIA.
Description
L'attributaria-checked indique si l'élément est sélectionné (true), non sélectionné (false), ou si l'état de sélection est indéterminé (mixed), c'est-à-dire ni sélectionné ni non sélectionné. La valeurmixed est prise en charge par les rôles de saisie à trois états :checkbox etmenuitemcheckbox.
La valeurmixed n'est pas prise en charge surradio,menuitemradio ouswitch ni sur les éléments qui héritent de ces rôles. Simixed est défini alors qu'il n'est pas pris en charge, la valeur sera considérée commefalse.
<span role="checkbox" aria-checked="false" tabindex="0" aria-labelledby="libelle-chk15"></span><label>S'abonner à la lettre d'information</label>L'attributtabindex est nécessaire pour permettre la sélection clavier. JavaScript est requis pour basculer l'étataria-checked. Et, si cette case à cocher fait partie d'un formulaire à soumettre, il faut encore plus de JavaScript pour définir un nom et une valeur.L'exemple ci-dessus pourrait être écrit ainsi :
<input type="checkbox" name="Abonnement" /><label for="libelle-chk15">S'abonner à la lettre d'information</label>En utilisant l'élément<input> avectype="checkbox" au lieu d'ARIA, aucun JavaScript n'est nécessaire.
Valeurs
- false
L'élément peut être sélectionné mais ne l'est pas actuellement.
- true
L'élément est sélectionné.
- mixed
Pour
checkboxetmenuitemcheckboxuniquement, équivalent à « indéterminé », indique une valeur mixte, ni sélectionné ni non sélectionné.- undefined (valeur par défaut)
L'élément ne prend pas en charge la sélection.
Rôles associés
Utilisé dans les rôles :
Interfaces associées
Element.ariaCheckedLa propriété
ariaChecked, qui fait partie de l'interfaceElement, reflète la valeur de l'attributaria-checked.ElementInternals.ariaCheckedLa propriété
ariaChecked, qui fait partie de l'interfaceElementInternals, reflète la valeur de l'attributaria-checked.
monElementHTML.ariaChecked = true;Spécifications
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-checked |
| Unknown specification |