Utiliser 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 curseur, un bouton tournant (potentiomètre) ou une barre de progression. Si la valeur courante n'est pas connue, l'attribut aria-valuenow
ne devrait pas être défini. Si aria-valuenow
a des valeurs minimale et maximale connues, on devrait définir les attributs aria-valuemin
et aria-valuemax
.
Lorsque la valeur rendue ne peut être précisément représentée par un nombre, les développeuses et 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, un 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
.
Valeur
Une chaîne de caractères qui représente le nombre.
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ée comme étant la position dans l'intervalle compris entre aria-valuemin
et aria-valuemax
si les deux sont définies, sinon la valeur actuelle avec un pourcentage.
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 valeur courante de 4.
<div role="slider" aria-valuenow="4" aria-valuemin="1" aria-valuemax="10">
Exemples concrets
progressbar
slider
spinbutton
Rôles ARIA concernés
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.