このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

ARIA: aria-valuenow 属性

aria-valuenow 属性は range ウィジェットの現在の値を定義します。

解説

aria-valuenow 属性は、範囲ウィジェットの現在の値を定義します。これは、<progress>、<meter>、および type が range、number、または日付・時刻型のいずれかである <input> の value 属性に似ています。

非セマンティック要素で meter、scrollbar、slider、および spinbutton を含む範囲型ロールを作成する場合、aria-valuenow を使用して最小値と最大値の間である現在の数値を定義できます。最小値と最大値は aria-valuemin と aria-valuemax で定義します。

警告: range ロール自体は 「抽象ロール」 であるため、使用しないでください。aria-valuenow 属性は、range ロールの全てのサブタイプで使用されます。

html
<p id="birthyearLabel">生まれた年は何年ですか?</p>
<div
  role="spinbutton"
  tabindex="-1"
  aria-valuenow="1984"
  aria-valuemin="1900"
  aria-valuemax="2021"
  aria-labelledby="birthyearLabel">
  <span class="value"> 1984 </span>
  <span role="button">
    <span aria-hidden="true">+</span>
    年を 1 増やす
  </span>
  <span role="button">
    <span aria-hidden="true">-</span>
    年を 1 減らす
  </span>
</div>

可能な場合は、意味を持つ HTML 要素を使用してください。

html
<label for="birthyear">生まれた年は何年ですか?</label>
<input type="number" id="birthyear" value="1984" min="1900" max="2021" />

進行状況バーが不確定な状態にあるときなど、既知の値がない場合には、aria-valuenow 属性を設定しないでください。

aria-valuenow が設定されていない場合は、現在の値に関する情報は示されません。

スライダーやスピンボタンと組み合わせて使用すると、支援技術は実際の値をユーザーに通知します。

進捗状況バーおよびスクロールバーと一緒に使用すると、支援技術は値をパーセントとしてユーザーに通知します。aria-valuemin と aria-valuemax が両方とも定義されている場合、パーセント値は範囲内の位置として計算されます。それ以外の場合は、実際の値がパーセントとして通知されます。

通知される値 (実際の値またはパーセント値) がユーザーにとって明確でない可能性がある場合は、aria-valuetext 属性を使用して、値をユーザーにとってわかりやすい形で表す必要があります。設定すると、aria-valuenow の数値の代わりに aria-valuetext の文字列が通知されます。例えば、スライダーが曜日を表し、曜日の aria-valuenow が数字である場合、aria-valuetext プロパティは、スライダーの値が理解できるような文字列 (「月曜日」など) に設定する必要があります。

値

<number>

最小値と最大値の間の 10 進数。

関連インターフェイス

Element.ariaValueNow

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

ElementInternals.ariaValueNow

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

関連付けられたロール

使用するロール:

継承先のロール:

例

html
<p id="temperatureLabel">オーブンの温度</p>
<div
  role="meter"
  id="temperature"
  aria-valuenow="205"
  aria-valuemin="70"
  aria-valuemax="250"
  aria-labelledby="temperatureLabel">
  <div class="meter-color" aria-hidden="true"></div>
</div>

ARIA を使用する際の第一のルールは、「必要な意味や動作がすでに組み込まれているネイティブ機能を使える場合は、要素を再利用して ARIA のロール、状態、プロパティを追加してアクセシブルにするのではなく、その機能を使う」というものです。

html
<label for="temperature">オーブンの温度</label>
<input type="range" id="temperature" value="205" min="70" max="250" step="5" />

<input> のようなネイティブ HTML 要素を使えば、スタイルと意味が最初から備わっています。

仕様書

仕様書
Accessible Rich Internet Applications (WAI-ARIA)
# aria-valuenow

関連情報