ARIA : attribut aria-pressed
L'attribut aria-pressed indique l'état « enfoncé » actuel d'un bouton à bascule.
Description
Ajouter aria-pressed à un élément ayant le rôle button transforme le bouton en bouton à bascule. L'attribut aria-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 sur true, false, mixed ou undefined. Pour aria-pressed, comme pour la plupart des types de valeurs tri-état, la valeur par défaut est undefined.
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 valeur mixed 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 pas aria-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'attribut aria-pressed.
Valeurs
false-
Le bouton peut être enfoncé mais ne l'est pas actuellement.
mixed-
Indique une valeur mixte pour un bouton à bascule tri-état.
true-
Le bouton est enfoncé.
undefined(valeur par défaut)-
L'élément ne prend pas en charge l'état enfoncé.
Interfaces associées
Element.ariaPressed-
La propriété
ariaPressed, qui fait partie de l'interfaceElement, reflète la valeur de l'attributaria-pressed. ElementInternals.ariaPressed-
La 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