--- title: ': HTML メーター要素' slug: Web/HTML/Element/meter tags: - Element - HTML - HTML forms - HTML5 - Reference - Web translation_of: Web/HTML/Element/meter ---
{{HTMLRef}}

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

{{EmbedInteractiveExample("pages/tabbed/meter.html", "tabbed-shorter")}}
コンテンツカテゴリ フローコンテンツ, 記述コンテンツ, ラベル付け可能コンテンツ, 知覚可能コンテンツ
許可されている内容 記述コンテンツ。ただし他の <meter> 要素の子孫要素として配置してはならない。
タグの省略 {{no_tag_omission}}
許可されている親要素 記述コンテンツを受け入れるすべての要素
暗黙の ARIA ロール 対応するロールなし
許可されている ARIA ロール 許可されている role なし
DOM インターフェイス {{domxref("HTMLMeterElement")}}

属性

他のすべての要素と同様に、この要素はグローバル属性を持ちます。

{{htmlattrdef("value")}}
現在の数値。min 属性と max 属性が指定されている場合、これらの表す範囲内に収まる値でなくてはなりません。この value 属性が未定義、あるいは不正な値であった場合は、その値は 0 となります。指定されている値が min 属性と max 属性が示す範囲の範囲外の値である場合、その範囲の内のもっとも近い値が適用されます。
注意: value 属性の値が 0 を下限、1 を上限とするものでない限り、min 属性および max 属性で value 属性の下限および上限を定義しなくてはなりません。
{{htmlattrdef("min")}}
範囲全体の下限。 max 属性により上限が設定されている場合は、それより小さい値でなくてはなりません。未設定の場合、下限値は 0 となります。
{{htmlattrdef("max")}}
範囲全体の上限。 min 属性により下限が設定されている場合は、それより大きい値でなくてはなりません。未設定の場合、上限値は 1 となります。
{{htmlattrdef("low")}}
「低」とされる範囲全体の上限値。属性値は、min 属性の値より大きく、かつ high 属性および max 属性の値より小さいものでなくてはなりません (※これらが定義されている場合)。low が未定義、もしくはその値が min 属性の値より小さい場合、low の値は最小値と同じです。
{{htmlattrdef("high")}}
「高」とされる範囲全体の下限値。属性値は、max 属性の値より小さく、かつ low 属性や min 属性の値より大きいものでなくてはなりません (※これらが定義されている場合)。high 属性が未定義、もしくはその値が max 属性の値より大きい場合、high の値は最大値と同じです。
{{htmlattrdef("optimum")}}
最適な数値の範囲を表します。min 属性と max 属性によって定義される範囲内の値でなくてはなりません。 low 属性と high 属性が指定されている場合、この属性の値を含む範囲が最適な数値の範囲とみなされます。例えば、値が min 属性と low 属性の間のいずれかであった場合、「低」の範囲が最適な数値となります。ブラウザーは optimum の値以下であるかどうかでメーターのバーの色を変更することがあります。
{{htmlattrdef("form")}}
<meter> 要素と関連付ける {{HTMLElement("form")}} 要素 (フォームオーナー) です。この属性の値は同じ文書内の <form> の {{htmlattrxref("id")}} である必要があります。この属性が設定されていなかった場合、その <meter> の祖先に <form> 要素があれば、それに関連付けられます。この属性は <meter> 要素がフォーム関連要素として使用されている場合、例えば対応する <input type="number"> の範囲を表示するようなものでのみ使用されます。

シンプルな例

HTML

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

結果

{{EmbedLiveSample("Simple_example", 300, 60)}}

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

meter1.png

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

この例では {{htmlattrxref("min", "meter")}} 属性が省略されています。よって、下限値は 0 となっています。

HTML

<p>He got a <meter low="69" high="80" max="100"
  value="84">B</meter> on the exam.</p>

結果

{{EmbedLiveSample("High_and_Low_range_example", 300, 60)}}

Google Chrome では、 meter の結果は次のように見えます。

meter2.png

仕様書

仕様書 状態 備考
{{SpecName('HTML WHATWG', 'forms.html#the-meter-element', '<meter>')}} {{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'sec-forms.html#the-meter-element', '<meter>')}} {{Spec2('HTML5 W3C')}} 初回定義

ブラウザーの互換性

{{Compat("html.elements.meter")}}

関連情報