<meter>: HTML メーター要素
<meter> は HTML の要素で、既知の範囲内のスカラー値、または小数値を表します。
試してみましょう
| コンテンツカテゴリー | フローコンテンツ, 記述コンテンツ, ラベル付け可能コンテンツ, 知覚可能コンテンツ |
|---|---|
| 許可されている内容 |
記述コンテンツ。ただし他の
<meter> 要素の子孫要素として配置してはならない。
|
| タグの省略 | 不可。開始と終了タグの両方が必要。 |
| 許可されている親要素 | 記述コンテンツを受け入れるすべての要素 |
| 暗黙の ARIA ロール | 対応するロールなし |
| 許可されている ARIA ロール | 許可されている role なし |
| DOM インターフェイス | HTMLMeterElement |
属性
他のすべての要素と同様に、この要素にはグローバル属性があります。
value-
現在の数値。これは指定されている場合、最小値と最大値(
min属性とmax属性)の間でなければなりません。このvalue属性が未定義、あるいは不正な値であった場合は、その値は0となります。指定されている値がmin属性とmax属性が示す範囲の範囲外の値である場合、その範囲の内のもっとも近い値が適用されます。メモ:
value属性の値が0を下限、1を上限とするものでない限り、min属性およびmax属性でvalue属性の下限および上限を定義しなくてはなりません。 min-
範囲全体の下限。
max属性により上限が設定されている場合は、それより小さい値でなくてはなりません。未設定の場合、下限値は0となります。 max-
範囲全体の上限。
min属性により下限が設定されている場合は、それより大きい値でなくてはなりません。未設定の場合、上限値は1となります。 low-
「低」とされる範囲全体の上限値。属性値は、
min属性の値より大きく、かつhigh属性およびmax属性の値より小さいものでなくてはなりません (※これらが定義されている場合)。lowが未定義、もしくはその値がmin属性の値より小さい場合、lowの値は最小値と同じです。 high-
「高」とされる範囲全体の下限値。属性値は、
max属性の値より小さく、かつlow属性やmin属性の値より大きいものでなくてはなりません (※これらが定義されている場合)。high属性が未定義、もしくはその値がmax属性の値より大きい場合、highの値は最大値と同じです。 optimum-
最適な数値の範囲を表します。
min属性とmax属性によって定義される範囲内の値でなくてはなりません。low属性とhigh属性が指定されている場合、この属性の値を含む範囲が最適な数値の範囲とみなされます。例えば、値がmin属性とlow属性の間のいずれかであった場合、「低」の範囲が最適な数値となります。ブラウザーは optimum の値以下であるかどうかでメーターのバーの色を変更することがあります。
例
シンプルな例
HTML
html
<p>
オーブンの温度: <meter min="200" max="500" value="350">350 度</meter>
</p>
結果
Google Chrome での表示結果は以下のようになります。
「高」の範囲と「低」の範囲の使用例
この例では min 属性が省略されています。よって、下限値は 0 となっています。
HTML
html
<p>
彼は試験で <meter low="69" high="80" max="100" value="84">B</meter> を取りました。
</p>
結果
Google Chrome では、 meter の結果は次のように見えます。
仕様書
| Specification |
|---|
| HTML Standard # the-meter-element |
ブラウザーの互換性
BCD tables only load in the browser