Mozilla wants to hear from developers like you. http://www.surveygizmo.com/s3/2737536/440b74c45e94?a=mdn

Utiliser l'attribut aria-valuetext

Cet article nécessite une relecture technique. Voici comment vous pouvez aider.

Cet article nécessite une relecture rédactionnelle. Voici comment vous pouvez aider.

Description

Cette technique présente l’utilisation de l’attribut aria-valuetext.

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.

Note : il existe plusieurs points de vue sur la façon dont les technologies d’assistance devraient traiter cette technique. L’information fournie ci-dessus est l’une de ces opinions et n’est pas normative.

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

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.

Autres ressources

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : Fredchat
 Dernière mise à jour par : Fredchat,