aria-valuetext

aria-valuetext 属性は、範囲ウィジェットのaria-valuenow の人間が読める代替テキストを定義します。

解説

数字は、パーセンテージであっても、必ずしもユーザーフレンドリーではありません。支援技術は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 属性をアナウンスします。