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-pressed
L'attributaria-pressed indique l'état « enfoncé » actuel d'un bouton à bascule.
Description
Ajouteraria-pressed à un élément ayant le rôlebutton transforme le bouton en bouton à bascule. L'attributaria-pressed n'est pertinent que pour les boutons à bascule. Il représente l'état « enfoncé » actuel du bouton.
La valeur est « tri-état », ce qui signifie qu'elle peut être définie surtrue,false,mixed ouundefined. Pouraria-pressed, comme pour la plupart des types de valeurs tri-état, la valeur par défaut estundefined.
Les boutons à bascule nécessitent un cycle complet d'appui et de relâchement pour changer leur valeur. Un appui et relâchement change la valeur àtrue. Un nouvel appui et relâchement la ramène àfalse.
Une valeurmixed signifie que les valeurs de plusieurs éléments contrôlés par le bouton ne sont pas toutes identiques.
Ne modifiez pas le contenu du label d'un bouton à bascule lorsque l'état change. Si le label du bouton indique « Pause », ne le changez pas en « Lecture » lorsque le bouton est enfoncé. Dans cet exemple, lorsque l'état enfoncé est vrai, le label reste « Pause » afin qu'un lecteur d'écran annonce « Bouton à bascule Pause enfoncé ».
<button aria-pressed="false">Pause</button>Si vous souhaitez que le label bascule entre « Pause » et « Lecture », n'utilisez pasaria-pressed.
La première règle d'utilisation d'ARIA est : « Si vous pouvez utiliser une fonctionnalité native avec la sémantique et le comportement requis déjà intégrés, au lieu de détourner un élément et d'ajouter un rôle, un état ou une propriété ARIA pour le rendre accessible, faites-le. » Si l'on utilise la sémantique HTML native avec<button>, on peut basculer le label au lieu de l'état enfoncé, ce qui supprime le besoin de l'attributaria-pressed.
Valeurs
falseLe bouton peut être enfoncé mais ne l'est pas actuellement.
mixedIndique une valeur mixte pour un bouton à bascule tri-état.
trueLe bouton est enfoncé.
undefined(valeur par défaut)L'élément ne prend pas en charge l'état enfoncé.
Interfaces associées
Element.ariaPressedLa propriété
ariaPressed, qui fait partie de l'interfaceElement, reflète la valeur de l'attributaria-pressed.ElementInternals.ariaPressedLa propriété
ariaPressed, qui fait partie de l'interfaceElementInternals, reflète la valeur de l'attributaria-pressed.
Rôles associés
Utilisé dans les rôles :
Spécifications
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-pressed |
Voir aussi
<input type="button"><input type="submit">- L'élément HTML
<button> - L'attribut ARIA
aria-checked - L'attribut ARIA
aria-selected