ARIA: aria-valuetext-Attribut
Das aria-valuetext-Attribut definiert den menschenlesbaren Text als Alternative zu aria-valuenow für ein Bereichs-Widget.
Beschreibung
Zahlen – selbst Prozentangaben – sind nicht immer benutzerfreundlich. Unterstützungstechnologien präsentieren aria-valuenow als numerische Werte. Wenn eine Fortschrittsanzeige bei 8% steht, was bedeutet das? aria-valuetext bietet eine Möglichkeit, den aktuellen Wert auf eine benutzerfreundlichere, für Menschen verständliche Weise darzustellen. Zum Beispiel könnte ein Batteriemeterwert als aria-valuetext="8% (noch 34 Minuten)" angegeben werden.
Das aria-valuetext-Attribut wird zusammen mit dem aria-valuenow-Attribut verwendet, nicht an dessen Stelle, es sei denn, dieser Wert ist nicht bekannt.
aria-valuetext wird nur benötigt, wenn der numerische Wert von aria-valuenow nicht aussagekräftig ist. Zum Beispiel sind die Werte eines Bereichs numerisch, können jedoch für nicht-numerische Werte verwendet werden, wie z. B. die College-Klassenstufe. Die Werte von aria-valuenow für ein vierjähriges College könnten von 1 bis 4 reichen, was die Position jedes Wertes im Wertbereich angibt. In diesem Fall könnte das aria-valuetext einer der folgenden Zeichenfolgen sein: "Erstes Jahr", "Sophomore", "Junior" und "Senior".
Wenn der numerische Wert aussagekräftig ist, wie z. B. ein Spinner mit aria-valuenow="3" für die Anzahl an Pizzastücken, die Sie bestellen möchten, ist aria-valuetext nicht erforderlich.
Wenn sowohl aria-valuetext als auch aria-valuenow enthalten sind, wird das aria-valuetext angesagt. Wenn kein aria-valuetext-Attribut vorhanden ist, werden die Unterstützungstechnologien das aria-valuenow-Attribut für den aktuellen Wert ansagen.
Werte
<string>-
Eine menschenlesbare Textalternative zum
aria-valuenow-Wert.
Zugehörige Schnittstellen
Element.ariaValueText-
Die
ariaValueText-Eigenschaft, die Teil derElement-Schnittstelle ist, spiegelt den Wert desaria-valuetext-Attributs wider. ElementInternals.ariaValueText-
Die
ariaValueText-Eigenschaft, die Teil derElementInternals-Schnittstelle ist, spiegelt den Wert desaria-valuetext-Attributs wider.
Zugehörige Rollen
Verwendet in Rollen:
Vererbt in Rollen:
Spezifikationen
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-valuetext |