aria-valuetext

数字は、パーセンテージであっても、必ずしもユーザーフレンドリーではありません。支援技術は aria-valuenow を数値として提示します。進行状況バーが 8% の場合、それは何を意味するのでしょうか？ aria-valuetext は、現在の値をよりユーザーフレンドリーで人間が理解しやすい方法で提示する方法を提供します。たとえば、バッテリーメーターの値は aria-valuetext="8% (34 minutes) remaining" として伝えられる場合があります。

その値が不明な場合を除き、aria-valuetext 属性は aria-valuenow 属性の代わりにではなく、aria-valuenow 属性とともに使用されます。

aria-valuetext は、aria-valuenow の数値が意味を持たない場合にのみ必要です。例えば、範囲の値は数値ですが、大学のクラスレベルなどの数値以外の値に使用される場合があります。4 年制大学の aria-valuenow の値は 1 から 4 の範囲になり、値空間内の各値の位置を示します。この場合、aria-valuetext は文字列「first year」、「sophomore」、「junior」、「senior」のいずれかになります。

ピザのスライスを何枚注文するかを示すスピナーが aria-valuenow="3" である場合など、数値に意味がある場合は aria-valuetext は必要ありません。

aria-valuetext と aria-valuenow の両方が含まれている場合は、aria-valuetext がアナウンスされます。aria-valuetext 属性がない場合、支援技術は現在の値の aria-valuenow 属性をアナウンスします。

<string>

aria-valuenow 値の人間が判読可能な代替テキスト。

Element.ariaValueText

Element インターフェイスの一部である ariaValueText プロパティは、aria-valuetext 属性の値を反映します。

ElementInternals.ariaValueText

ElementInternals インターフェイスの一部である ariaValueText プロパティは、aria-valuetext 属性の値を反映します。

使用するロール:

• range
• separator
• spinbutton

継承先のロール:

• meter
• progressbar
• scrollbar
• slider
• spinbutton

• aria-valuenow