Description
L’attribut aria-valuetext
est utilisé pour définir un texte alternatif, lisible par l'homme, de la valeur aria-valuenow
d’un composant à intervalle tel qu’une barre de progression, un bouton rotatif spinbutton
ou un curseur slider
.
Les développeurs DEVRAIENT uniquement définir l’attribut aria-valuetext
lorsque la valeur retournée ne peut pas être précisément représentée sous forme de nombre.
Par exemple, dans le cas d'un curseur qui peut retourner les valeurs petite
, moyenne
et grand
, les valeurs de aria-valuenow
pourraient aller de 1 à 3, indiquant ainsi la position de chaque valeur dans l’intervalle, mais la valeur de aria-valuetext
sera l'une des chaînes suivantes : petite
, moyenne
ou grande
.
Valeurs
Représentation d’un nombre sous forme d'une chaîne
Effets possibles sur les agents utilisateurs et les technologies d’assistance
Si l’attribut aria-valuetext
est absent, les technologies d’assistance compteront uniquement sur l’attribut aria-valuenow
pour la valeur courante. Si aria-valuetext
est spécifié, les technologies d’assistance DEVRAIENT retourner cette valeur plutôt que celle de aria-valuenow
.
Exemples
Exemple 1 :
L’extrait de code ci-dessous montre un curseur simple de sélection d’un jour de la semaine. La valeur du curseur est numérique, et l’attribut aria-valuetext
est utilisé pour fournir le nom de jour. L’application actualisera programmatiquement aria-valuetext
selon la valeur de aria-valuenow
.
<div role="slider" aria-valuenow="1"
aria-valuemin="1" aria-valuemax="7"
aria-valuetext="Dimanche">
Exemples concrets :
Notes
Utilisé avec les rôles ARIA
- progressbar ;
- scrollbar ;
- slider
- spinbutton.
Techniques ARIA connexes
Compatibilité
À définir : ajouter les informations de prise en charge pour les combinaisons les plus courantes d’agents utilisateurs et de produits de technologies d’assistance.