mozilla
Vos résultats de recherche

    Utiliser l'attribut aria-valuenow

    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-valuenow.

    L’attribut aria-valuenow est utilisé pour définir la valeur courante de l’intervalle d’un composant tel qu’un slider, spinbutton ou une progressbar. Si la valeur courante n'est pas connue, le développeur ne devraient pas définir l’attribut aria-valuenow. Si aria-valuenow a des valeurs minimale et maximale connues, le développeur devrait définir les attributs aria-valuemin et aria-valuemax.

    Lorsque la valeur retournée ne peut être précisément représentée par une nombre, les développeurs DEVRAIENT utiliser l’attribut aria-valuetext en conjonction avec aria-valuenow pour fournir une représentation humainement lisible de la valeur courante. Par exemple, une curseur peut avoir des valeurs retournées comme petite, moyenne et grande. Dans ce cas, les valeurs de aria-valuenow peuvent varier de 1 à 3, ce qui indique la position de chaque valeur dans l'espace de valeurs, mais la valeur de aria-valuetext sera l’une des chaînes : petite, moyenne ou grande.

    L’attribut aria-valuenow est obligatoire pour les rôles slider, scrollbar et spinbutton.

    Valeurs

    Représentation d’un nombre par une chaîne

    Effets possibles sur les agents utilisateurs et les technologies d’assistance

    Pour les éléments possédant les rôles progressbar et scrollbar, les technologies d’assistance DEVRAIENT renvoyer la valeur courante sous forme de pourcentage, calculé comme étant la position dans l'intervalle compris entre aria-valuemin et aria-valuemax si les deux sont définies, otherwise the actual value with a percent indicator.

    Pour les éléments possédant les rôles slider et spinbutton, les technologies d’assistance DEVRAIENT retourner la valeur courante à l’utilisateur.

    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 affiche un curseur simple avec une caleur courante de 4.

    <div role="slider" aria-valuenow="4" aria-valuemin="1" aria-valuemax="10">
    

    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,