aria-valuetext
Das aria-valuetext Attribut definiert den lesbaren Text, der als Alternative zu aria-valuenow für ein Bereichs-Widget dient.
Beschreibung
Zahlen – sogar Prozentsätze – sind nicht immer benutzerfreundlich. Unterstützende Technologien stellen aria-valuenow als numerische Werte dar. Wenn eine Fortschrittsanzeige bei 8% ist, was bedeutet das? aria-valuetext bietet eine Möglichkeit, den aktuellen Wert auf eine benutzerfreundlichere und verständlichere Weise darzustellen. Zum Beispiel könnte ein Wert eines Batterieanzeigers als aria-valuetext="8% (34 Minuten) verbleibend" angezeigt werden.
Das aria-valuetext Attribut wird zusammen mit dem aria-valuenow Attribut verwendet, nicht anstelle davon, es sei denn, dieser Wert ist nicht bekannt.
aria-valuetext ist nur erforderlich, wenn der numerische Wert von aria-valuenow nicht aussagekräftig ist. Zum Beispiel sind die Werte eines Bereichs numerisch, können aber für nicht numerische Werte wie das Niveau einer Universitätsklasse verwendet werden. Die Werte von aria-valuenow für ein 4-jähriges Hochschulstudium könnten von 1 bis 4 reichen, was die Position jedes Werts im Werteraum anzeigt. In diesem Fall könnte der aria-valuetext einer der Strings sein: "erstes Jahr", "zweites Jahr", "drittes Jahr" und "viertes Jahr".
Wenn der numerische Wert aussagekräftig ist, wie bei einem Spinner mit aria-valuenow="3", um die Anzahl der Pizzastücke zu bestellen, wird aria-valuetext nicht benötigt.
Sind sowohl aria-valuetext als auch aria-valuenow vorhanden, wird aria-valuetext angesagt. Befindet sich kein aria-valuetext Attribut, so kündigen unterstützende Technologien das aria-valuenow Attribut für den aktuellen Wert an.
Werte
<string>-
Ein lesbarer Text als Alternative zum
aria-valuenowWert.
Zugehörige Schnittstellen
Element.ariaValueText-
Die
ariaValueTextEigenschaft, Teil derElementSchnittstelle, spiegelt den Wert desaria-valuetextAttributs wider. ElementInternals.ariaValueText-
Die
ariaValueTextEigenschaft, Teil derElementInternalsSchnittstelle, spiegelt den Wert desaria-valuetextAttributs wider.
Zugehörige Rollen
Verwendet in Rollen:
Geerbt in Rollen:
Spezifikationen
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-valuetext |