Dasaria-valuetext-Attribut definiert den menschenlesbaren Text als Alternative zuaria-valuenow für ein Bereichs-Widget.

Beschreibung

Zahlen – selbst Prozentangaben – sind nicht immer benutzerfreundlich. Unterstützungstechnologien präsentierenaria-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 alsaria-valuetext="8% (noch 34 Minuten)" angegeben werden.

Dasaria-valuetext-Attribut wird zusammen mit demaria-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 vonaria-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 vonaria-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 dasaria-valuetext einer der folgenden Zeichenfolgen sein: "Erstes Jahr", "Sophomore", "Junior" und "Senior".

Wenn der numerische Wert aussagekräftig ist, wie z. B. ein Spinner mitaria-valuenow="3" für die Anzahl an Pizzastücken, die Sie bestellen möchten, istaria-valuetext nicht erforderlich.

Wenn sowohlaria-valuetext als aucharia-valuenow enthalten sind, wird dasaria-valuetext angesagt. Wenn keinaria-valuetext-Attribut vorhanden ist, werden die Unterstützungstechnologien dasaria-valuenow-Attribut für den aktuellen Wert ansagen.

Werte

<string>

Eine menschenlesbare Textalternative zumaria-valuenow-Wert.

Zugehörige Schnittstellen

Element.ariaValueText

DieariaValueText-Eigenschaft, die Teil derElement-Schnittstelle ist, spiegelt den Wert desaria-valuetext-Attributs wider.

ElementInternals.ariaValueText

DieariaValueText-Eigenschaft, die Teil derElementInternals-Schnittstelle ist, spiegelt den Wert desaria-valuetext-Attributs wider.

Zugehörige Rollen

Verwendet in Rollen:

• range
• separator
• spinbutton

Vererbt in Rollen:

• meter
• progressbar
• scrollbar
• slider
• spinbutton

Spezifikationen

Siehe auch

• aria-valuenow