aria-valuetext 属性の使用

aria-valuetext 属性は、プログレスバー、スピンボタン、スライダーなどの範囲ウィジェットの aria-valuenow に対する人間が読める代替テキストを定義するために使用されます。

作成者は、レンダリングされた値を数値として正確に表現できない場合にのみ、aria-valuetext 属性を設定するべきです（SHOULD）。 たとえば、スライダーのレンダリング値が小、中、大の場合があります。 この場合、aria-valuenow の値は 1 〜 3 の範囲で値空間内の各値の位置を示しますが、aria-valuetext は、小、中、大のいずれかの文字列になります。

値

数値の文字列表現

ユーザーエージェントと支援技術への影響

aria-valuetext 属性がない場合、支援技術は現在の値の aria-valuenow 属性のみに依存します。 aria-valuetext が指定されている場合、支援技術は aria-valuenow の値の代わりにその値をレンダリングするべきです（SHOULD）。

例

例 1:

下のスニペットは、曜日を選択するための簡単なスライダーを示しています。 スライダーの値は数値で、aria-valuetext 属性を使用してその日の名前を指定します。 アプリケーションは、aria-valuenow に応じてプログラムで aria-valuetext を更新します。

<div role="slider" aria-valuenow="1" 
	aria-valuemin="1" aria-valuemax="7"
	aria-valuetext="日曜日">

動作する例

注 

ARIA ロールで使用

• progressbar
• scrollbar
• slider
• spinbutton

関連する ARIA 技術 

• aria-valuenow

互換性

TBD: 一般的な UA と AT 製品の組み合わせに関するサポート情報を追加する

その他のリソース

• aria-valuetext の WAI-ARIA 仕様（英語）