aria-valuenow 属性の使用

aria-valuenow 属性は、スライダー、スピンボタン、プログレスバーなどの範囲ウィジェットの現在の値を定義するために使用されます。 現在の値がわからない場合は、aria-valuenow 属性を設定しないでください。 aria-valuenow に既知の最小値と最大値がある場合、作成者は aria-valuemin 属性と aria-valuemax 属性を設定するべきです。

レンダリングされた値を数値として正確に表現できない場合、作成者は aria-valuetext 属性を aria-valuenow と組み合わせて使用して、範囲の現在の値の使いやすい表現を提供するべきです(SHOULD)。 たとえば、スライダーのレンダリング値がの場合があります。 この場合、aria-valuenow の値は 1 〜 3 の範囲で値空間内の各値の位置を示しますが、aria-valuetext は、のいずれかの文字列になります。

aria-valuenowスライダースクロールバースピンボタンのロールの必須属性です。

数値の文字列表現

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

プログレスバースクロールバーのロールを持つ要素の場合、支援技術は、aria-valuemin から aria-valuemax までの範囲の位置として計算された実際の値をパーセンテージとしてレンダリングするべきです(SHOULD)。

スライダースピンボタンのロールを持つ要素の場合、支援技術は実際の値をユーザーにレンダリングするべきです(SHOULD)。

: 支援技術がこの手法をどのように扱うべきかについての意見は異なる場合があります。 上記の情報は、これらの意見の1つで、したがって規範的ではありません。

例 1:

下のスニペットは、現在の値が 4 の単純なスライダーを示しています。

<div role="slider" aria-valuenow="4" aria-valuemin="1" aria-valuemax="10">

動作する例

注 

ARIA ロールで使用

互換性

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

その他のリソース

 

ドキュメントのタグと貢献者

タグ: 
このページの貢献者: Wind1808
最終更新者: Wind1808,