HTML の <meter>
要素は、既知の範囲内のスカラー値、または小数値を表します。
このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 https://github.com/mdn/interactive-examples をクローンしてプルリクエストを送信してください。
コンテンツカテゴリ | フローコンテンツ, 記述コンテンツ, ラベル付け可能コンテンツ, 知覚可能コンテンツ |
---|---|
許可されている内容 | 記述コンテンツ。ただし他の <meter> 要素の子孫要素として配置してはならない。 |
タグの省略 | {{no_tag_omission}} |
許可されている親要素 | 記述コンテンツを受け入れるすべての要素 |
暗黙の ARIA ロール | 対応するロールなし |
許可されている ARIA ロール | 許可されている role なし |
DOM インターフェイス | {{domxref("HTMLMeterElement")}} |
他のすべての要素と同様に、この要素はグローバル属性を持ちます。
min
属性と max
属性が指定されている場合、これらの表す範囲内に収まる値でなくてはなりません。この value
属性が未定義、あるいは不正な値であった場合は、その値は 0
となります。指定されている値が min
属性と max
属性が示す範囲の範囲外の値である場合、その範囲の内のもっとも近い値が適用されます。
value
属性の値が 0
を下限、1
を上限とするものでない限り、min
属性および max
属性で value
属性の下限および上限を定義しなくてはなりません。max
属性により上限が設定されている場合は、それより小さい値でなくてはなりません。未設定の場合、下限値は 0
となります。min
属性により下限が設定されている場合は、それより大きい値でなくてはなりません。未設定の場合、上限値は 1
となります。min
属性の値より大きく、かつ high
属性および max
属性の値より小さいものでなくてはなりません (※これらが定義されている場合)。low
が未定義、もしくはその値が min
属性の値より小さい場合、low
の値は最小値と同じです。max
属性の値より小さく、かつ low
属性や min
属性の値より大きいものでなくてはなりません (※これらが定義されている場合)。high
属性が未定義、もしくはその値が max
属性の値より大きい場合、high
の値は最大値と同じです。min
属性と max
属性によって定義される範囲内の値でなくてはなりません。 low
属性と high
属性が指定されている場合、この属性の値を含む範囲が最適な数値の範囲とみなされます。例えば、値が min
属性と low
属性の間のいずれかであった場合、「低」の範囲が最適な数値となります。ブラウザーは optimum の値以下であるかどうかでメーターのバーの色を変更することがあります。<meter>
要素と関連付ける {{HTMLElement("form")}} 要素 (フォームオーナー) です。この属性の値は同じ文書内の <form>
の {{htmlattrxref("id")}} である必要があります。この属性が設定されていなかった場合、その <meter>
の祖先に <form>
要素があれば、それに関連付けられます。この属性は <meter>
要素がフォーム関連要素として使用されている場合、例えば対応する <input type="number">
の範囲を表示するようなものでのみ使用されます。<p>オーブンの温度: <meter min="200" max="500" value="350">350 degrees</meter></p>
{{EmbedLiveSample("Simple_example", 300, 60)}}
Google Chrome での表示結果は以下のようになります。
この例では {{htmlattrxref("min", "meter")}} 属性が省略されています。よって、下限値は 0
となっています。
<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 の結果は次のように見えます。
仕様書 | 状態 | 備考 |
---|---|---|
{{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")}}