1.仕様
METER要素は、
既知の範囲内の
スカラー測定値、
または分数値を
表します。
- meter
-
メーター (meter)
- 種類
-
通常要素
- カテゴリ
-
- フロー
コンテンツ - フレージング
コンテンツ - ラベル付け可能な
要素 - パルパブル
コンテンツ
- フロー
- 使用できるコンテキスト
-
フレージング
コンテンツ を受け入れる要素フレージング
コンテンツ を受け入れる要素のコンテンツとして、使用できます。フレージング
コンテンツ を受け入れる要素は、h1要素 , h2要素 , h3要素 , h4要素 , h5要素 , h6要素 , p要素 , pre要素 , output要素 , progress要素 , meter要素 , label要素 , datalist要素 , body要素 , section要素 , nav要素 , aside要素 , article要素 , header要素 , footer要素 , main要素 , address要素 , li要素 , dt要素 , dd要素 , caption要素 , th要素 , td要素 , form要素 , fieldset要素 , search要素 , blockquote要素 , figure要素 , figcaption要素 , div要素 , dialog要素 , abbr要素 , b要素 , bdi要素 , bdo要素 , cite要素 , code要素 , data要素 , dfn要素 , em要素 , i要素 , kbd要素 , mark要素 , q要素 , s要素 , samp要素 , small要素 , span要素 , strong要素 , sub要素 , sup要素 , u要素 , var要素 です。 - コンテンツモデル
-
0個以上のフレージング
コンテンツ (meter要素 を除く)0個以上のフレージング
コンテンツ が配置できます。ですが、meter要素 は子孫に持てません。meter
要素 を除くフレージングコンテンツ に分類される要素は、script要素 , noscript要素 , template要素 , input要素 , textarea要素 , select要素 , label要素 , button要素 , output要素 , progress要素 , datalist要素 , picture要素 , object要素 , img要素 , iframe要素 , embed要素 , video要素 , audio要素 , canvas要素 , map要素 , area要素 , a要素 , ins要素 , del要素 , abbr要素 , b要素 , bdi要素 , bdo要素 , cite要素 , code要素 , data要素 , dfn要素 , em要素 , i要素 , kbd要素 , mark要素 , q要素 , s要素 , samp要素 , small要素 , span要素 , strong要素 , sub要素 , sup要素 , u要素 , var要素 , time要素 , ruby要素 , br要素 , wbr要素 , slot要素 , テキスト です。 - タグの省略
-
どちらのタグも省略できません。
- DOM インターフェイス
-
HTMLMeterElement
[Exposed=Window]
interface HTMLMeterElement : HTMLElement {
[HTMLConstructor] constructor();
[CEReactions] attribute double value;
[CEReactions] attribute double min;
[CEReactions] attribute double max;
[CEReactions] attribute double low;
[CEReactions] attribute double high;
[CEReactions] attribute double optimum;
readonly attribute NodeList labels;
};
HTMLElement
[Exposed=Window]
interface HTMLElement : Element {
[HTMLConstructor] constructor();
// metadata attributes
[CEReactions] attribute DOMString title;
[CEReactions] attribute DOMString lang;
[CEReactions] attribute boolean translate;
[CEReactions] attribute DOMString dir;
// user interaction
[CEReactions] attribute (boolean or unrestricted double or DOMString)? hidden;
[CEReactions] attribute DOMString inert;
undefined click();
[CEReactions] attribute DOMString accessKey;
readonly attribute DOMString accessKeyLabel;
[CEReactions] attribute boolean draggable;
[CEReactions] attribute boolean spellcheck;
[CEReactions] attribute DOMString writingSuggestions;
[CEReactions] attribute DOMString autocapitalize;
[CEReactions] attribute [LegacyNullToEmptyString] DOMString innerText;
[CEReactions] attribute [LegacyNullToEmptyString] DOMString outerText;
ElementInternals attachInternals();
// The popover API
undefined showPopover();
undefined hidePopover();
boolean togglePopover(optional boolean force);
[CEReactions] attribute DOMString? popover;
};
HTMLElement includes GlobalEventHandlers;
HTMLElement includes ElementContentEditable;
HTMLElement includes HTMLOrSVGElement;
Element
[Exposed=Window]
interface Element : Node {
readonly attribute DOMString? namespaceURI;
readonly attribute DOMString? prefix;
readonly attribute DOMString localName;
readonly attribute DOMString tagName;
[CEReactions] attribute DOMString id;
[CEReactions] attribute DOMString className;
[SameObject, PutForwards=value] readonly attribute DOMTokenList classList;
[CEReactions, Unscopable] attribute DOMString slot;
boolean hasAttributes();
[SameObject] readonly attribute NamedNodeMap attributes;
sequence<DOMString> getAttributeNames();
DOMString? getAttribute(DOMString qualifiedName);
DOMString? getAttributeNS(DOMString? namespace, DOMString localName);
[CEReactions] undefined setAttribute(DOMString qualifiedName, DOMString value);
[CEReactions] undefined setAttributeNS(DOMString? namespace, DOMString qualifiedName, DOMString value);
[CEReactions] undefined removeAttribute(DOMString qualifiedName);
[CEReactions] undefined removeAttributeNS(DOMString? namespace, DOMString localName);
[CEReactions] boolean toggleAttribute(DOMString qualifiedName, optional boolean force);
boolean hasAttribute(DOMString qualifiedName);
boolean hasAttributeNS(DOMString? namespace, DOMString localName);
Attr? getAttributeNode(DOMString qualifiedName);
Attr? getAttributeNodeNS(DOMString? namespace, DOMString localName);
[CEReactions] Attr? setAttributeNode(Attr attr);
[CEReactions] Attr? setAttributeNodeNS(Attr attr);
[CEReactions] Attr removeAttributeNode(Attr attr);
ShadowRoot attachShadow(ShadowRootInit init);
readonly attribute ShadowRoot? shadowRoot;
Element? closest(DOMString selectors);
boolean matches(DOMString selectors);
boolean webkitMatchesSelector(DOMString selectors); // legacy alias of .matches
HTMLCollection getElementsByTagName(DOMString qualifiedName);
HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
HTMLCollection getElementsByClassName(DOMString classNames);
[CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // legacy
undefined insertAdjacentText(DOMString where, DOMString data); // legacy
};
GlobalEventHandlers
interface mixin GlobalEventHandlers {
attribute EventHandler onabort;
attribute EventHandler onauxclick;
attribute EventHandler onbeforeinput;
attribute EventHandler onbeforematch;
attribute EventHandler onbeforetoggle;
attribute EventHandler onblur;
attribute EventHandler oncancel;
attribute EventHandler oncanplay;
attribute EventHandler oncanplaythrough;
attribute EventHandler onchange;
attribute EventHandler onclick;
attribute EventHandler onclose;
attribute EventHandler oncontextlost;
attribute EventHandler oncontextmenu;
attribute EventHandler oncontextrestored;
attribute EventHandler oncopy;
attribute EventHandler oncuechange;
attribute EventHandler oncut;
attribute EventHandler ondblclick;
attribute EventHandler ondrag;
attribute EventHandler ondragend;
attribute EventHandler ondragenter;
attribute EventHandler ondragleave;
attribute EventHandler ondragover;
attribute EventHandler ondragstart;
attribute EventHandler ondrop;
attribute EventHandler ondurationchange;
attribute EventHandler onemptied;
attribute EventHandler onended;
attribute OnErrorEventHandler onerror;
attribute EventHandler onfocus;
attribute EventHandler onformdata;
attribute EventHandler oninput;
attribute EventHandler oninvalid;
attribute EventHandler onkeydown;
attribute EventHandler onkeypress;
attribute EventHandler onkeyup;
attribute EventHandler onload;
attribute EventHandler onloadeddata;
attribute EventHandler onloadedmetadata;
attribute EventHandler onloadstart;
attribute EventHandler onmousedown;
[LegacyLenientThis] attribute EventHandler onmouseenter;
[LegacyLenientThis] attribute EventHandler onmouseleave;
attribute EventHandler onmousemove;
attribute EventHandler onmouseout;
attribute EventHandler onmouseover;
attribute EventHandler onmouseup;
attribute EventHandler onpaste;
attribute EventHandler onpause;
attribute EventHandler onplay;
attribute EventHandler onplaying;
attribute EventHandler onprogress;
attribute EventHandler onratechange;
attribute EventHandler onreset;
attribute EventHandler onresize;
attribute EventHandler onscroll;
attribute EventHandler onscrollend;
attribute EventHandler onsecuritypolicyviolation;
attribute EventHandler onseeked;
attribute EventHandler onseeking;
attribute EventHandler onselect;
attribute EventHandler onslotchange;
attribute EventHandler onstalled;
attribute EventHandler onsubmit;
attribute EventHandler onsuspend;
attribute EventHandler ontimeupdate;
attribute EventHandler ontoggle;
attribute EventHandler onvolumechange;
attribute EventHandler onwaiting;
attribute EventHandler onwebkitanimationend;
attribute EventHandler onwebkitanimationiteration;
attribute EventHandler onwebkitanimationstart;
attribute EventHandler onwebkittransitionend;
attribute EventHandler onwheel;
};
ElementContentEditable
interface mixin ElementContentEditable {
[CEReactions] attribute DOMString contentEditable;
[CEReactions] attribute DOMString enterKeyHint;
readonly attribute boolean isContentEditable;
[CEReactions] attribute DOMString inputMode;
};
HTMLOrSVGElement
interface mixin HTMLOrSVGElement {
[SameObject] readonly attribute DOMStringMap dataset;
attribute DOMString nonce; // intentionally no [CEReactions]
[CEReactions] attribute boolean autofocus;
[CEReactions] attribute long tabIndex;
undefined focus(optional FocusOptions options = {});
undefined blur();
};
- ARIA in HTML
-
暗黙的="
meter
" ARIAロール="No
" aria-* 属性="GlobalAny
"暗黙的な ARIAセマンティクスは、
role=meter
です。作成者は、暗黙的な ARIAセマンティクス, または HTML要素のネイティブセマンティクスを上書きしてはいけません。
グローバル aria-* 属性と、許可されたロールに適用される任意の aria-* 属性が記述できます。
作者はmeter要素にaria-valuemax属性やaria-valuemin属性を使うべきではありません。 - レンダリング
- インライン
レベル ボックス フォーム
コントロール meter {
display: inline-block;
block-size: 1em;
inline-size: 5em;
vertical-align: -0.2em;
appearance: auto;
}
CSS を大雑把に読むと、 インラインレベルのブロックコンテナボックス(インラインブロック)を生成します。 などになります。
- 説明
-
meter
要素 は、既知の範囲内のスカラー測定値、または分数値を表します。たとえば、ディスク使用量、クエリ結果の関連性、特定の候補者を選択した投票人口の割合などです。<!DOCTYPE html>
<html lang=
"ja"> <head>
<meta charset=
"utf-8"> <title>meter要素の例 - (Example of meter element) | 離珠のHTMLでしぃ!</title>
</head>
<body>
<h1>meter要素の例</h1>
<form action=
"../Html/fmreceive.htm" oninput= "imtMeter.value = nipInput.valueAsNumber; imtMeter.textContent = nipInput.valueAsNumber;"> <input id=
"iipInput" name= "nipInput" type= "number" value= "50"> <meter id=
"imtMeter" name= "nmtMeter" value= "50" min= "10" max= "100" low= "30" high= "60" optimum= "70">50</meter> <button name=
"nbtSender" value= "../Html/exmeter.htm">ボタン</button> <br>受信用の<br>ページへ
</form>
</body>
</html>
このサンプルへのリンクです。
(./exmeter.htm) - 参照元
-
参照元
- HTML Living Standard. 4.10.14 The meter element (Last Updated 27 August 2024)
- HTML Living Standard. 15 Rendering 15.5.14 The meter element (Last Updated 27 August 2024)
- HTML 5.2 W3C 勧告. 4.10.14 The meter element (W3C勧告、2017年12月14日)
- HTML 5.2 W3C 勧告. 10.5.12. The meter element. (W3C勧告、2017年12月14日)
- HTML 5.1 W3C 勧告. 4.10.15. The meter element (W3C勧告、2016年11月1日)
- HTML 5.1 W3C 勧告. 10.5.12. The meter element. (W3C勧告、2016年11月1日)
- HTML 5 W3C 勧告. 4.10.15 The meter element (W3C勧告、2014年10月28日)
- HTML 5 W3C 勧告. 10.5.11 The meter element. (W3C勧告、2014年10月28日)
- <meter>: HTML メーター要素 - HTML: ハイパーテキストマークアップ言語 | MDN
- JSONデータ
-
JSON形式での、データのイメージです。
{
"meter": {
"check": "2024-09-01",
"group": "Form",
"element": "- - (%Phrasing)* -(meter) -- meter. (Normal elements.) [Flow|Phrasing|Labelable|Palpable] --",
"attlist": {
"%Global;": "",
"value": "NUMBER #IMPLIED -- Current value of the element --",
"min": "NUMBER 0 -- Lower bound of range --",
"max": "NUMBER 1.0 -- Upper bound of range --",
"low": "NUMBER #IMPLIED -- High limit of low range --",
"high": "NUMBER #IMPLIED -- Low limit of high range --",
"optimum": "NUMBER #IMPLIED -- Optimum value in gauge --",
},
"comment": "メーター (meter)",
"point": "既知の範囲内のスカラー測定値、または分数値を表します。たとえば、ディスク使用量、クエリ結果の関連性、特定の候補者を選択した投票人口の割合などです。",
"kind": "Normal",
"categories": [
"Flow",
"Phrasing",
"Labelable",
"Palpable",
],
"used": "parent (%Phrasing)*",
"contentmodel": "meter (%Phrasing)* -(meter)",
"tag": [
"-",
"-",
],
"attributes": {
"value": "要素の現在値",
"min": "範囲の下限",
"max": "範囲の上限",
"low": "低域の上限",
"high": "高域の下限",
"optimum": "ゲージの最適値",
},
"dominterface": "HTMLMeterElement",
"rendering": "Form",
"reference": [
{
"title": "HTML Living Standard. 4.10.14 The meter element.",
"href": "https://html.spec.whatwg.org/multipage/form-elements.html#the-meter-element",
"heading": "HTML Living Standard. 4.10.14 The meter element",
"sub": "Last Updated 27 August 2024",
},
{
"title": "HTML Living Standard. 15 Rendering 15.5.14 The meter element.",
"href": "https://html.spec.whatwg.org/multipage/rendering.html#the-meter-element-2",
"heading": "HTML Living Standard. 15 Rendering 15.5.14 The meter element",
"sub": "Last Updated 27 August 2024",
},
{
"title": "HTML 5.2 W3C Recommendation. 4.10.14 The meter element. W3C Recommendation, 14 December 2017.",
"href": "https://www.w3.org/TR/2017/REC-html52-20171214/sec-forms.html#the-meter-element",
"heading": "HTML 5.2 W3C 勧告. 4.10.14 The meter element",
"sub": "W3C勧告、2017年12月14日",
},
{
"title": "HTML 5.2 W3C Recommendation. 10.5.12. The meter element.",
"href": "https://www.w3.org/TR/2017/REC-html52-20171214/rendering.html#the-meter-element-rendering",
"heading": "HTML 5.2 W3C 勧告. 10.5.12. The meter element.",
"sub": "W3C勧告、2017年12月14日",
},
{
"title": "HTML 5.1 W3C Recommendation. 4.10.15. The meter element. W3C Recommendation, 1 November 2016.",
"href": "https://www.w3.org/TR/2016/REC-html51-20161101/sec-forms.html#the-meter-element",
"heading": "HTML 5.1 W3C 勧告. 4.10.15. The meter element",
"sub": "W3C勧告、2016年11月1日",
},
{
"title": "HTML 5.1 W3C Recommendation. 10.5.12. The meter element. W3C Recommendation, 1 November 2016.",
"href": "https://www.w3.org/TR/2016/REC-html51-20161101/rendering.html#the-meter-element-rendering",
"heading": "HTML 5.1 W3C 勧告. 10.5.12. The meter element.",
"sub": "W3C勧告、2016年11月1日",
},
{
"title": "HTML 5 W3C Recommendation. 4.10.15 The meter element. W3C Recommendation, 28 October 2014.",
"href": "https://www.w3.org/TR/2014/REC-html5-20141028/forms.html#the-meter-element",
"heading": "HTML 5 W3C 勧告. 4.10.15 The meter element",
"sub": "W3C勧告、2014年10月28日",
},
{
"title": "HTML 5 W3C Recommendation. 10.5.11 The meter element. W3C Recommendation, 28 October 2014.",
"href": "https://www.w3.org/TR/2014/REC-html5-20141028/rendering.html#the-meter-element-0",
"heading": "HTML 5 W3C 勧告. 10.5.11 The meter element.",
"sub": "W3C勧告、2014年10月28日",
},
{
"title": "MDN Web Docs. HTML <meter>: The HTML Meter element.",
"href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/meter",
"heading": "<meter>: HTML メーター要素 - HTML: ハイパーテキストマークアップ言語 | MDN",
},
],
"version": {
"first": "HTML5",
"latest": "HTML Living Standard",
},
}
}
注意: 簡易に描画する為に、各項目の後ろに
,
を付与しています。JSON の形式では、末尾の項目の後には,
は付けません。 - 最終確認日
-
2024-09-01
2.使用可能な箇所
フレージング
受け入れる要素に
配置できます。
meter
フレージング
尚 厳密に言うと、コンテンツ
3.配置できるコンテンツ
フレージングコンテンツを
配置できます。
meter
フレージング
4.属性
グローバル属性と、
value,
min, max,
low, high,
optimum を
設定できます。
meterは、グローバル属性とvalue属性, min属性, max属性, low属性, high属性, optimum属性を設定できます。
<label>進行状況の例示: <meter value=
"0.7"> 0.7 </meter> </label>
改めて全体を提示していない限り、この雛型のmeter
例示では見易さの為に、meterにスタイルシートで装飾(幅)の指定をしています。
value属性
<meter value=
"0.7" >0.7 </meter>
valueは、ゲージが「測定」値として示す値を指定します。
valueは、指定する必要があります。その値は有効な浮動小数点数である必要があります。
該当する場合は、次の不等式が成立する必要があります。それぞれ属性名で表しています。
- min ≦ value ≦ max
- min ≦ low ≦ max (lowが指定されている場合)
- min ≦ high ≦ max (highが指定されている場合)
- min ≦ optimum ≦ max (optimumが指定されている場合)
- low ≦ high (lowとhighの両方が指定されている場合)
min属性
<meter value=
"0.7" min= "0.5" >0.7 </meter>
minは、範囲の下限を指定します。
minが指定されている場合は、最小値(minimum) はその属性の値になります。それ以外の場合は 0 になります。
該当する場合は、次の不等式が成立する必要があります。それぞれ属性名で表しています。
- min ≦ value ≦ max
- min ≦ low ≦ max (lowが指定されている場合)
- min ≦ high ≦ max (highが指定されている場合)
- min ≦ optimum ≦ max (optimumが指定されている場合)
- low ≦ high (lowとhighの両方が指定されている場合)
max属性
<meter value=
"0.7" max= "2.0" >0.7 </meter>
maxは、範囲の上限を指定します。
maxが指定されている場合は、最大値(maximum) はその属性の値になります。それ以外の場合は 1.0 になります。
該当する場合は、次の不等式が成立する必要があります。それぞれ属性名で表しています。
- min ≦ value ≦ max
- min ≦ low ≦ max (lowが指定されている場合)
- min ≦ high ≦ max (highが指定されている場合)
- min ≦ optimum ≦ max (optimumが指定されている場合)
- low ≦ high (lowとhighの両方が指定されている場合)
low属性
<meter value=
"0.7" low= "0.6" >0.7 </meter> <meter value=
"0.5" low= "0.6" >0.5 </meter>
lowは、「低」部分と見なされる範囲を指定します。
optimalは「最適」な位置を示します。これが「高」値よりも高い場合は、値が高いほど良いことを示します。これが「低」マークよりも低い場合は、低い値が良いことを示します。当然、その中間の場合は、高い値も低い値も良くないことを示します。
該当する場合は、次の不等式が成立する必要があります。それぞれ属性名で表しています。
- min ≦ value ≦ max
- min ≦ low ≦ max (lowが指定されている場合)
- min ≦ high ≦ max (highが指定されている場合)
- min ≦ optimum ≦ max (optimumが指定されている場合)
- low ≦ high (lowとhighの両方が指定されている場合)
high属性
<meter value=
"0.9" high= "0.8" >0.9 </meter> <meter value=
"0.7" high= "0.8" >0.7 </meter>
highは、「高」部分と見なされる範囲を指定します。
optimalは「最適」な位置を示します。これが「高」値よりも高い場合は、値が高いほど良いことを示します。これが「低」マークよりも低い場合は、低い値が良いことを示します。当然、その中間の場合は、高い値も低い値も良くないことを示します。
該当する場合は、次の不等式が成立する必要があります。それぞれ属性名で表しています。
- min ≦ value ≦ max
- min ≦ low ≦ max (lowが指定されている場合)
- min ≦ high ≦ max (highが指定されている場合)
- min ≦ optimum ≦ max (optimumが指定されている場合)
- low ≦ high (lowとhighの両方が指定されている場合)
optimum属性
<meter value=
"0.9" low= "0.6" high= "0.8" optimum= "0.85" >0.9 </meter> <meter value=
"0.7" low= "0.6" high= "0.8" optimum= "0.85" >0.7 </meter> <meter value=
"0.5" low= "0.6" high= "0.8" optimum= "0.85" >0.5 </meter>
highは、「高」部分と見なされる範囲を指定します。
optimalは「最適」な位置を示します。これが「高」値よりも高い場合は、値が高いほど良いことを示します。これが「低」マークよりも低い場合は、低い値が良いことを示します。当然、その中間の場合は、高い値も低い値も良くないことを示します。
該当する場合は、次の不等式が成立する必要があります。それぞれ属性名で表しています。
- min ≦ value ≦ max
- min ≦ low ≦ max (lowが指定されている場合)
- min ≦ high ≦ max (highが指定されている場合)
- min ≦ optimum ≦ max (optimumが指定されている場合)
- low ≦ high (lowとhighの両方が指定されている場合)
5.Web API
id属性を用いて
getElementById()メソッドで
要素を取得する方法がお勧めです。
meter
6.レンダリング
meter {
display: inline-block;
appearance: auto;
block-size: 1em;
inline-size: 5em;
vertical-align: -0.2em;
}
meter
コードを見易くする為に要素毎に改行すると、改行コードがスペースと扱われて意図しない隙間が表れる事があります。 描画を重視するかコードの見易さを重視するか、折衷案でタグの内で改行するか、いろいろ配慮が必要です。
この提示は、想定されるネイティブな外観の一部です。この記述を代用する要素に指定しても、指定が足りなくて期待する描画にはならないでしょう。
7.気を付ける点
カテゴリ
meter
meter