メインコンテンツへスキップ

meter要素


1.仕様

METER要素は、
既知の範囲内の
スカラー測定値、
または分数値を
表します。

meter

メーター (meter)

種類

通常要素

カテゴリ

タグの省略

どちらのタグも省略できません。

コンテンツ属性
グローバル属性 他
value属性
要素の現在値
min属性
範囲の下限
max属性
範囲の上限
low属性
低域の上限
high属性
高域の下限
optimum属性
ゲージの最適値
DOM インターフェイス
HTMLMeterElement
  1. [Exposed=Window]
  2. interface HTMLMeterElement : HTMLElement {
  3. [HTMLConstructor] constructor();
  4.  
  5. [CEReactions] attribute double value;
  6. [CEReactions] attribute double min;
  7. [CEReactions] attribute double max;
  8. [CEReactions] attribute double low;
  9. [CEReactions] attribute double high;
  10. [CEReactions] attribute double optimum;
  11. readonly attribute NodeList labels;
  12. };
HTMLElement
  1. [Exposed=Window]
  2. interface HTMLElement : Element {
  3. [HTMLConstructor] constructor();
  4.  
  5. // metadata attributes
  6. [CEReactions] attribute DOMString title;
  7. [CEReactions] attribute DOMString lang;
  8. [CEReactions] attribute boolean translate;
  9. [CEReactions] attribute DOMString dir;
  10.  
  11. // user interaction
  12. [CEReactions] attribute (boolean or unrestricted double or DOMString)? hidden;
  13. [CEReactions] attribute DOMString inert;
  14. undefined click();
  15. [CEReactions] attribute DOMString accessKey;
  16. readonly attribute DOMString accessKeyLabel;
  17. [CEReactions] attribute boolean draggable;
  18. [CEReactions] attribute boolean spellcheck;
  19. [CEReactions] attribute DOMString writingSuggestions;
  20. [CEReactions] attribute DOMString autocapitalize;
  21.  
  22. [CEReactions] attribute [LegacyNullToEmptyString] DOMString innerText;
  23. [CEReactions] attribute [LegacyNullToEmptyString] DOMString outerText;
  24.  
  25. ElementInternals attachInternals();
  26.  
  27. // The popover API
  28. undefined showPopover();
  29. undefined hidePopover();
  30. boolean togglePopover(optional boolean force);
  31. [CEReactions] attribute DOMString? popover;
  32. };
  33.  
  34. HTMLElement includes GlobalEventHandlers;
  35. HTMLElement includes ElementContentEditable;
  36. HTMLElement includes HTMLOrSVGElement;
Element
  1. [Exposed=Window]
  2. interface Element : Node {
  3. readonly attribute DOMString? namespaceURI;
  4. readonly attribute DOMString? prefix;
  5. readonly attribute DOMString localName;
  6. readonly attribute DOMString tagName;
  7.  
  8. [CEReactions] attribute DOMString id;
  9. [CEReactions] attribute DOMString className;
  10. [SameObject, PutForwards=value] readonly attribute DOMTokenList classList;
  11. [CEReactions, Unscopable] attribute DOMString slot;
  12.  
  13. boolean hasAttributes();
  14. [SameObject] readonly attribute NamedNodeMap attributes;
  15. sequence<DOMString> getAttributeNames();
  16. DOMString? getAttribute(DOMString qualifiedName);
  17. DOMString? getAttributeNS(DOMString? namespace, DOMString localName);
  18. [CEReactions] undefined setAttribute(DOMString qualifiedName, DOMString value);
  19. [CEReactions] undefined setAttributeNS(DOMString? namespace, DOMString qualifiedName, DOMString value);
  20. [CEReactions] undefined removeAttribute(DOMString qualifiedName);
  21. [CEReactions] undefined removeAttributeNS(DOMString? namespace, DOMString localName);
  22. [CEReactions] boolean toggleAttribute(DOMString qualifiedName, optional boolean force);
  23. boolean hasAttribute(DOMString qualifiedName);
  24. boolean hasAttributeNS(DOMString? namespace, DOMString localName);
  25.  
  26. Attr? getAttributeNode(DOMString qualifiedName);
  27. Attr? getAttributeNodeNS(DOMString? namespace, DOMString localName);
  28. [CEReactions] Attr? setAttributeNode(Attr attr);
  29. [CEReactions] Attr? setAttributeNodeNS(Attr attr);
  30. [CEReactions] Attr removeAttributeNode(Attr attr);
  31.  
  32. ShadowRoot attachShadow(ShadowRootInit init);
  33. readonly attribute ShadowRoot? shadowRoot;
  34.  
  35. Element? closest(DOMString selectors);
  36. boolean matches(DOMString selectors);
  37. boolean webkitMatchesSelector(DOMString selectors); // legacy alias of .matches
  38.  
  39. HTMLCollection getElementsByTagName(DOMString qualifiedName);
  40. HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
  41. HTMLCollection getElementsByClassName(DOMString classNames);
  42.  
  43. [CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // legacy
  44. undefined insertAdjacentText(DOMString where, DOMString data); // legacy
  45. };
GlobalEventHandlers
  1. interface mixin GlobalEventHandlers {
  2. attribute EventHandler onabort;
  3. attribute EventHandler onauxclick;
  4. attribute EventHandler onbeforeinput;
  5. attribute EventHandler onbeforematch;
  6. attribute EventHandler onbeforetoggle;
  7. attribute EventHandler onblur;
  8. attribute EventHandler oncancel;
  9. attribute EventHandler oncanplay;
  10. attribute EventHandler oncanplaythrough;
  11. attribute EventHandler onchange;
  12. attribute EventHandler onclick;
  13. attribute EventHandler onclose;
  14. attribute EventHandler oncontextlost;
  15. attribute EventHandler oncontextmenu;
  16. attribute EventHandler oncontextrestored;
  17. attribute EventHandler oncopy;
  18. attribute EventHandler oncuechange;
  19. attribute EventHandler oncut;
  20. attribute EventHandler ondblclick;
  21. attribute EventHandler ondrag;
  22. attribute EventHandler ondragend;
  23. attribute EventHandler ondragenter;
  24. attribute EventHandler ondragleave;
  25. attribute EventHandler ondragover;
  26. attribute EventHandler ondragstart;
  27. attribute EventHandler ondrop;
  28. attribute EventHandler ondurationchange;
  29. attribute EventHandler onemptied;
  30. attribute EventHandler onended;
  31. attribute OnErrorEventHandler onerror;
  32. attribute EventHandler onfocus;
  33. attribute EventHandler onformdata;
  34. attribute EventHandler oninput;
  35. attribute EventHandler oninvalid;
  36. attribute EventHandler onkeydown;
  37. attribute EventHandler onkeypress;
  38. attribute EventHandler onkeyup;
  39. attribute EventHandler onload;
  40. attribute EventHandler onloadeddata;
  41. attribute EventHandler onloadedmetadata;
  42. attribute EventHandler onloadstart;
  43. attribute EventHandler onmousedown;
  44. [LegacyLenientThis] attribute EventHandler onmouseenter;
  45. [LegacyLenientThis] attribute EventHandler onmouseleave;
  46. attribute EventHandler onmousemove;
  47. attribute EventHandler onmouseout;
  48. attribute EventHandler onmouseover;
  49. attribute EventHandler onmouseup;
  50. attribute EventHandler onpaste;
  51. attribute EventHandler onpause;
  52. attribute EventHandler onplay;
  53. attribute EventHandler onplaying;
  54. attribute EventHandler onprogress;
  55. attribute EventHandler onratechange;
  56. attribute EventHandler onreset;
  57. attribute EventHandler onresize;
  58. attribute EventHandler onscroll;
  59. attribute EventHandler onscrollend;
  60. attribute EventHandler onsecuritypolicyviolation;
  61. attribute EventHandler onseeked;
  62. attribute EventHandler onseeking;
  63. attribute EventHandler onselect;
  64. attribute EventHandler onslotchange;
  65. attribute EventHandler onstalled;
  66. attribute EventHandler onsubmit;
  67. attribute EventHandler onsuspend;
  68. attribute EventHandler ontimeupdate;
  69. attribute EventHandler ontoggle;
  70. attribute EventHandler onvolumechange;
  71. attribute EventHandler onwaiting;
  72. attribute EventHandler onwebkitanimationend;
  73. attribute EventHandler onwebkitanimationiteration;
  74. attribute EventHandler onwebkitanimationstart;
  75. attribute EventHandler onwebkittransitionend;
  76. attribute EventHandler onwheel;
  77. };
ElementContentEditable
  1. interface mixin ElementContentEditable {
  2. [CEReactions] attribute DOMString contentEditable;
  3. [CEReactions] attribute DOMString enterKeyHint;
  4. readonly attribute boolean isContentEditable;
  5. [CEReactions] attribute DOMString inputMode;
  6. };
HTMLOrSVGElement
  1. interface mixin HTMLOrSVGElement {
  2. [SameObject] readonly attribute DOMStringMap dataset;
  3. attribute DOMString nonce; // intentionally no [CEReactions]
  4.  
  5. [CEReactions] attribute boolean autofocus;
  6. [CEReactions] attribute long tabIndex;
  7. undefined focus(optional FocusOptions options = {});
  8. undefined blur();
  9. };
ARIA in HTML
暗黙的="meter" ARIAロール="No" aria-* 属性="GlobalAny"

暗黙的な ARIAセマンティクスは、role=meter です。

作成者は、暗黙的な ARIAセマンティクス, または HTML要素のネイティブセマンティクスを上書きしてはいけません。

グローバル aria-* 属性と、許可されたロールに適用される任意の aria-* 属性が記述できます。
作者はmeter要素にaria-valuemax属性やaria-valuemin属性を使うべきではありません。

レンダリング
インラインレベルボックス
フォームコントロール
  1. meter {
  2. display: inline-block;
  3. block-size: 1em;
  4. inline-size: 5em;
  5. vertical-align: -0.2em;
  6. appearance: auto;
  7. }

CSS を大雑把に読むと、 インラインレベルのブロックコンテナボックス(インラインブロック)を生成します。 などになります。

説明
meter要素は、既知の範囲内のスカラー測定値、または分数値を表します。たとえば、ディスク使用量、クエリ結果の関連性、特定の候補者を選択した投票人口の割合などです。
  1. <!DOCTYPE html>
  2. <html lang="ja">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>meter要素の例 - (Example of meter element) | 離珠のHTMLでしぃ!</title>
  6. </head>
  7. <body>
  8. <h1>meter要素の例</h1>
  9. <form action="../Html/fmreceive.htm" oninput="imtMeter.value = nipInput.valueAsNumber; imtMeter.textContent = nipInput.valueAsNumber;">
  10. <input id="iipInput" name="nipInput" type="number" value="50">
  11. <meter id="imtMeter" name="nmtMeter" value="50" min="10" max="100" low="30" high="60" optimum="70">50</meter>
  12. <button name="nbtSender" value="../Html/exmeter.htm">ボタン</button>
  13. <br>受信用の<br>ページへ
  14. </form>
  15. </body>
  16. </html>

このサンプルへのリンクです。
(./exmeter.htm)

JSONデータ
JSON形式での、データのイメージです。
  1. {
  2. "meter": {
  3. "check": "2024-09-01",
  4. "group": "Form",
  5. "element": "- - (%Phrasing)* -(meter) -- meter. (Normal elements.) [Flow|Phrasing|Labelable|Palpable] --",
  6. "attlist": {
  7. "%Global;": "",
  8. "value": "NUMBER #IMPLIED -- Current value of the element --",
  9. "min": "NUMBER 0 -- Lower bound of range --",
  10. "max": "NUMBER 1.0 -- Upper bound of range --",
  11. "low": "NUMBER #IMPLIED -- High limit of low range --",
  12. "high": "NUMBER #IMPLIED -- Low limit of high range --",
  13. "optimum": "NUMBER #IMPLIED -- Optimum value in gauge --",
  14. },
  15. "comment": "メーター (meter)",
  16. "point": "既知の範囲内のスカラー測定値、または分数値を表します。たとえば、ディスク使用量、クエリ結果の関連性、特定の候補者を選択した投票人口の割合などです。",
  17. "kind": "Normal",
  18. "categories": [
  19. "Flow",
  20. "Phrasing",
  21. "Labelable",
  22. "Palpable",
  23. ],
  24. "used": "parent (%Phrasing)*",
  25. "contentmodel": "meter (%Phrasing)* -(meter)",
  26. "tag": [
  27. "-",
  28. "-",
  29. ],
  30. "attributes": {
  31. "value": "要素の現在値",
  32. "min": "範囲の下限",
  33. "max": "範囲の上限",
  34. "low": "低域の上限",
  35. "high": "高域の下限",
  36. "optimum": "ゲージの最適値",
  37. },
  38. "dominterface": "HTMLMeterElement",
  39. "rendering": "Form",
  40. "reference": [
  41. {
  42. "title": "HTML Living Standard. 4.10.14 The meter element.",
  43. "href": "https://html.spec.whatwg.org/multipage/form-elements.html#the-meter-element",
  44. "heading": "HTML Living Standard. 4.10.14 The meter element",
  45. "sub": "Last Updated 27 August 2024",
  46. },
  47. {
  48. "title": "HTML Living Standard. 15 Rendering 15.5.14 The meter element.",
  49. "href": "https://html.spec.whatwg.org/multipage/rendering.html#the-meter-element-2",
  50. "heading": "HTML Living Standard. 15 Rendering 15.5.14 The meter element",
  51. "sub": "Last Updated 27 August 2024",
  52. },
  53. {
  54. "title": "HTML 5.2 W3C Recommendation. 4.10.14 The meter element. W3C Recommendation, 14 December 2017.",
  55. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/sec-forms.html#the-meter-element",
  56. "heading": "HTML 5.2 W3C 勧告. 4.10.14 The meter element",
  57. "sub": "W3C勧告、2017年12月14日",
  58. },
  59. {
  60. "title": "HTML 5.2 W3C Recommendation. 10.5.12. The meter element.",
  61. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/rendering.html#the-meter-element-rendering",
  62. "heading": "HTML 5.2 W3C 勧告. 10.5.12. The meter element.",
  63. "sub": "W3C勧告、2017年12月14日",
  64. },
  65. {
  66. "title": "HTML 5.1 W3C Recommendation. 4.10.15. The meter element. W3C Recommendation, 1 November 2016.",
  67. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/sec-forms.html#the-meter-element",
  68. "heading": "HTML 5.1 W3C 勧告. 4.10.15. The meter element",
  69. "sub": "W3C勧告、2016年11月1日",
  70. },
  71. {
  72. "title": "HTML 5.1 W3C Recommendation. 10.5.12. The meter element. W3C Recommendation, 1 November 2016.",
  73. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/rendering.html#the-meter-element-rendering",
  74. "heading": "HTML 5.1 W3C 勧告. 10.5.12. The meter element.",
  75. "sub": "W3C勧告、2016年11月1日",
  76. },
  77. {
  78. "title": "HTML 5 W3C Recommendation. 4.10.15 The meter element. W3C Recommendation, 28 October 2014.",
  79. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/forms.html#the-meter-element",
  80. "heading": "HTML 5 W3C 勧告. 4.10.15 The meter element",
  81. "sub": "W3C勧告、2014年10月28日",
  82. },
  83. {
  84. "title": "HTML 5 W3C Recommendation. 10.5.11 The meter element. W3C Recommendation, 28 October 2014.",
  85. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/rendering.html#the-meter-element-0",
  86. "heading": "HTML 5 W3C 勧告. 10.5.11 The meter element.",
  87. "sub": "W3C勧告、2014年10月28日",
  88. },
  89. {
  90. "title": "MDN Web Docs. HTML <meter>: The HTML Meter element.",
  91. "href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/meter",
  92. "heading": "<meter>: HTML メーター要素 - HTML: ハイパーテキストマークアップ言語 | MDN",
  93. },
  94. ],
  95. "version": {
  96. "first": "HTML5",
  97. "latest": "HTML Living Standard",
  98. },
  99. }
  100. }

注意: 簡易に描画する為に、各項目の後ろに , を付与しています。JSON の形式では、末尾の項目の後には , は付けません。

最終確認日

2024-09-01


2.使用可能な箇所

フレージングコンテンツ
受け入れる要素に
配置できます。

meter要素を使用できる状態(コンテキストContext)は、フレージングコンテンツを受け入れる要素に配置できます。ただし、祖先にmeter要素が存在してはなりません。

フレージングコンテンツを受け入れる要素(meter要素除く)は、h1要素, h2要素, h3要素, h4要素, h5要素, h6要素, p要素, pre要素, output要素, progress要素, 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要素 です。

尚 厳密に言うと、コンテンツモデルフレージングコンテンツ, フローコンテンツのいずれかである要素に配置できます。少なくとも現在は、カテゴリフレージングコンテンツである要素はフローコンテンツでもあります。なので、コンテンツモデルフローコンテンツである要素にはカテゴリフレージングコンテンツである要素も配置できるのが現状です。


3.配置できるコンテンツ

フレージングコンテンツを
配置できます。


4.属性

グローバル属性と、
value,
min, max,
low, high,
optimum を
設定できます。

meterは、グローバル属性value属性, min属性, max属性, low属性, high属性, optimum属性を設定できます。

  1. <label>進行状況の例示: <meter value="0.7">0.7</meter></label>

改めて全体を提示していない限り、この雛型のmeter要素を置き換えてデモとしています。

例示では見易さの為に、meterにスタイルシートで装飾(幅)の指定をしています。

value属性

  1. <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属性

  1. <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属性

  1. <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属性

  1. <meter value="0.7" low="0.6">0.7</meter>
  2. <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属性

  1. <meter value="0.9" high="0.8">0.9</meter>
  2. <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属性

  1. <meter value="0.9" low="0.6" high="0.8" optimum="0.85">0.9</meter>
  2. <meter value="0.7" low="0.6" high="0.8" optimum="0.85">0.7</meter>
  3. <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要素を表すプロパティはないので、idを用いて documentgetElementById()メソッドで、要素を取得する方法がお勧めです。この時に取得できるのはHTMLMeterElement オブジェクトです。


6.レンダリング

  1. meter {
  2. display: inline-block;
  3. appearance: auto;
  4. block-size: 1em;
  5. inline-size: 5em;
  6. vertical-align: -0.2em;
  7. }

meter要素は、インラインレベルのブロックコンテナボックス(インラインブロック)を生成します。

コードを見易くする為に要素毎に改行すると、改行コードがスペースと扱われて意図しない隙間が表れる事があります。 描画を重視するかコードの見易さを重視するか、折衷案でタグの内で改行するか、いろいろ配慮が必要です。

この提示は、想定されるネイティブな外観の一部です。この記述を代用する要素に指定しても、指定が足りなくて期待する描画にはならないでしょう。


7.気を付ける点

カテゴリ

meter要素は、ラベル付け可能な要素ではありますが、formコンテンツではありません。

meter要素(内容コンテンツContent)として、0 以上のフレージングコンテンツを配置できます。ただしこの要素は、デボルブ可能なウィジェットです。(ウィジェットとは、グラフィカルユーザインタフェース(GUI)を構成するインタフェース部品の総称です。) そしてその描画の為の値は、属性から指定します。このコンテンツは、その描画の機能に対応していないユーザーエージェントを想定してのものです。