ARIA : attribut aria-readonly
L'attribut aria-readonly indique que l'élément n'est pas modifiable, mais reste utilisable.
Description
Lorsque vous souhaitez indiquer qu'un élément interactif fonctionne mais n'est pas modifiable, définissez aria-readonly="true". Cela indique à l'utilisateur·ice qu'un élément interactif normalement sélectionnable et copiable a été placé en mode lecture seule (et non désactivé).
Quand aria-readonly est défini à true, cela signifie que l'utilisateur·ice peut lire mais pas modifier la valeur du widget. Les éléments en lecture seule restent pertinents pour l'utilisateur·ice : il ne faut pas empêcher la navigation vers l'élément ou ses descendants sélectionnables, ni la copie de la valeur.
Exemples :
- Éléments de formulaire qui ne doivent pas être modifiés.
- En-têtes de ligne et de colonne dans un tableur.
- La valeur totale dans un panier d'achat.
Si la valeur non modifiable ne doit pas pouvoir recevoir la sélection, utilisez aria-disabled à la place.
Note :
Lorsque vous utilisez des contrôles de formulaire HTML sémantiques, si vous définissez l'attribut readonly, il n'est pas nécessaire d'ajouter aria-readonly="true".
Note :
La valeur d'un <input type="checkbox"> ne peut pas être modifiée, ce qui rend readonly non pertinent. Cependant, lors de la création de cases à cocher avec role="checkbox", l'attribut aria-readonly est pris en charge.
Valeurs
true-
L'élément est en lecture seule.
false(valeur par défaut)-
L'élément n'est pas en lecture seule.
Interfaces associées
Element.ariaReadOnly-
La propriété
ariaReadOnly, qui fait partie de l'interfaceElement, reflète la valeur de l'attributaria-readonly. ElementInternals.ariaReadOnly-
La propriété
ariaReadOnly, qui fait partie de l'interfaceElementInternals, reflète la valeur de l'attributaria-readonly.
Rôles associés
Utilisé dans les rôles :
Hérité dans les rôles :
Spécifications
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-readonly |
Voir aussi
- L'attribut HTML
readonly - L'attribut ARIA
aria-disabled