1.仕様
METER要素は、
既知の範囲内の
スカラー測定値、
または分数値を
表します。
METER - - (%Phrasing)* -(meter) -- meter. (Normal elements.) [Flow
- 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>要素 , テキスト, <meta>要素 , <link>要素 です。 - タグの省略
-
どちらのタグも省略できません。
- 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.DOM インターフェイス
id属性を用いて
getElementById()メソッドで
要素を取得する方法がお勧めです。
meter
6.アクセシビリティ
7.レンダリング
meter {
display: inline-block;
appearance: auto;
block-size: 1em;
inline-size: 5em;
vertical-align: -0.2em;
}
meter
コードを見易くする為に要素毎に改行すると、改行コードがスペースと扱われて意図しない隙間が表れる事があります。 描画を重視するかコードの見易さを重視するか、折衷案でタグの内で改行するか、いろいろ配慮が必要です。
この提示は、想定されるネイティブな外観の一部です。この記述を代用する要素に指定しても、指定が足りなくて期待する描画にはならないでしょう。
8.気を付ける点
カテゴリ
meter
meter