ARIA : attribut aria-readonly

L'attributaria-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éfinissezaria-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é).

Quandaria-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, utilisezaria-disabled à la place.

Note :Lorsque vous utilisez des contrôles de formulaire HTML sémantiques, si vous définissez l'attributreadonly, il n'est pas nécessaire d'ajouteraria-readonly="true".

Note :La valeur d'un<input type="checkbox"> ne peut pas être modifiée, ce qui rendreadonly non pertinent. Cependant, lors de la création de cases à cocher avecrole="checkbox", l'attributaria-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.