Utiliser l'attribut aria-valuetext

Description

L’attribut aria-valuetext est utilisé pour définir une alternative texte humainement lisible de la valeur aria-valuenow d’un composant à intervalle tels 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, un curseur peut avoir les valeurs retournées petite, moyenneet grande. Dans ce cas, les valeurs de aria-valuenow peuvent aller de 1 à 3, ce qui indique la position de chaque valeur dans l’intervalle, mais aria-valuetext sera une des chaînes suivantes : petite, moyenne ou grande.

Valeurs

Représentation d’un nombre par 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

• aria-valuenow.

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.

Autres ressources

• Spécification WAI-ARIA pour l’attribut aria-valuetext.