HTML の <meter> 要素は、既知の範囲内のスカラー値、または小数値を表します。

この要素は、例えばディスクの使用状況や、選挙における全投票数中の特定の候補者の得票数など、その範囲が明確な文脈内でのみ使用可能です。つまり、身長や体重・貯金額・降雨量・サッカーの得点など、範囲の曖昧な量や個数に対して用いることは不適切であるということです。また、進捗率を表すにはこの要素でなく progress 要素が適しています。

コンテンツカテゴリー フローコンテンツ記述コンテンツ、ラベル付け可能コンテンツ、知覚可能コンテンツ
許可された内容 記述コンテンツ。ただし他の <meter> 要素の子孫要素として配置してはならない。
タグの省略 不可。開始と終了タグの両方が必要。
許可された親要素 記述コンテンツを受け入れるすべての要素
許可された ARIA ロール なし
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 属性が指定されている場合、この属性の値を含む範囲が最適な数値の範囲とみなされます。例えば optinum 属性の値が min 属性と low 属性の間のいずれかである場合、「低」の範囲が最適な数値となります。
form
meter 要素の属するフォーム (form owner) の id を指定します。例えばフォームの input 要素 (<input type="number" />) の範囲を表す用途で meter 要素を用いている場合、このフォームの id を指定します。対象がフォーム関連要素である場合にのみこの属性を使用可能です。meter 要素が関連するフォームの子孫要素として配置されているのなら、そのメーターは自動的にそのフォームに属するものとなり、この属性は省略可能です。

シンプルな例

HTML コンテンツ

<p>オーブンの温度: <meter min="200" max="500"
  value="350">350 degrees</meter></p>

表示結果

Google Chrome での表示結果は以下のようになります。

meter1.png

「高」の範囲と「低」の範囲の使用例

この例では、min 属性が省略されています。よって、下限値は 0 となっています。

HTML コンテンツ

<p>山田太郎くんの期末試験の点数: <meter low="69" high="80" max="100"
  value="84">B</meter></p>

表示結果

Google Chrome での表示結果は以下のようになります。山田くんは赤点です。

meter2.png

仕様策定状況

仕様書 策定状況 コメント
HTML Living Standard
<meter> の定義
現行の標準  
HTML5
<meter> の定義
勧告  

ブラウザーの対応

機能ChromeEdgeFirefoxInternet ExplorerOperaSafari
基本対応6 あり16 なし116
form6 あり16 なし116
high6 あり16 なし116
low6 あり16 なし116
max6 あり16 なし116
min6 あり16 なし116
optimum6 あり16 なし116
value6 あり16 なし116
機能Android webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
基本対応 なし ? あり1611 なし ?
form なし ? あり1611 なし ?
high なし ? あり1611 なし ?
low なし ? あり1611 なし ?
max なし ? あり1611 なし ?
min なし ? あり1611 なし ?
optimum なし ? あり1611 なし ?
value なし ? あり1611 なし ?

関連情報

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

 このページの貢献者: mfuji09, SphinxKnight, yyss, ethertank
 最終更新者: mfuji09,