string

aria-valuetext

Fournit un texte alternatif lisible par l'humain pour la valeur numérique courante d'un widget de plage.

Description

aria-valuetext remplace l’annonce de aria-valuenow par les technologies d’assistance quand la valeur numérique brute n’est pas suffisamment explicite. Par exemple, un curseur de note 3 peut être annoncé “Bien” plutôt que “3”.

Syntaxe

<div role="slider"
     aria-valuemin="0"
     aria-valuemax="100"
     aria-valuenow="60"
     aria-valuetext="60 %"
     aria-label="Volume">
</div>

Exemples

Évaluation par étoiles :

<div role="slider"
     tabindex="0"
     aria-label="Note"
     aria-valuemin="1"
     aria-valuemax="5"
     aria-valuenow="4"
     aria-valuetext="4 étoiles sur 5 — Très bien">
</div>

Curseur de température :

<div role="slider"
     aria-valuemin="16"
     aria-valuemax="30"
     aria-valuenow="22"
     aria-valuetext="22 degrés Celsius"
     aria-label="Température du thermostat">
</div>

Notes

Priorité sur aria-valuenow : quand aria-valuetext est présent, les lecteurs d’écran annoncent ce texte à la place de la valeur numérique. Les deux attributs doivent rester synchronisés.

Mettre à jour dynamiquement : à chaque changement de aria-valuenow, mettre à jour aria-valuetext en conséquence.

Texte concis : la valeur doit être courte et directement compréhensible — éviter les phrases longues.

Support navigateurs