mozilla
Vos résultats de recherche

    Utiliser l'attribut aria-valuetext

    Cet article nécessite une relecture technique.

    Cet article nécessite une relecture rédactionnelle.

    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 : 
    Contributors to this page: Fredchat
    Dernière mise à jour par : Fredchat,