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

progress要素

1.仕様

PROGRESS要素は、
タスクの完了の
進行状況を
表します。

progress

進行状況インジケーター (progress indicator)

種類

通常要素

カテゴリ

使用できるコンテキスト
フレージングコンテンツを受け入れる要素

フレージングコンテンツを受け入れる要素のコンテンツとして、使用できます。

フレージングコンテンツを受け入れる要素は、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個以上のフレージングコンテンツ (progress要素 を除く)

0個以上のフレージングコンテンツが配置できます。ですが、progress要素は子孫に持てません。

progress要素を除くフレージングコンテンツに分類される要素は、script要素, noscript要素, template要素, input要素, textarea要素, select要素, label要素, button要素, output要素, meter要素, 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要素, テキスト です。

タグの省略

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

コンテンツ属性
グローバル属性 他
value属性
要素の現在値
max属性
範囲の上限
DOM インターフェイス
HTMLProgressElement
  1. [Exposed=Window]
  2. interface HTMLProgressElement : HTMLElement {
  3. [HTMLConstructor] constructor();
  4.  
  5. [CEReactions] attribute double value;
  6. [CEReactions] attribute double max;
  7. readonly attribute double position;
  8. readonly attribute NodeList labels;
  9. };
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
暗黙的="progressbar" ARIAロール="No" aria-* 属性="GlobalAny"

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

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

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

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

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

説明
progress要素は、タスクの完了の進行状況を表します。進行状況は不確定であり、進行は進んでいるが、タスクが完了するまでにどれだけの作業が残っているかが不明である事を示しているか (タスクがリモートホストの応答を待っている為など)、進行状況が不明であるかのどちらかです。0 から最大までの範囲の数値で、これまでに完了した作業の割合を示します。
  1. <!DOCTYPE html>
  2. <html lang="ja">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>progress要素の例 - (Example of progress element) | 離珠のHTMLでしぃ！</title>
  6. </head>
  7. <body>
  8. <h1>progress要素の例</h1>
  9. <form action="../Html/fmreceive.htm" oninput="iprProgress.value = nipInput.valueAsNumber; iprProgress.textContent = nipInput.valueAsNumber + '%';">
  10. <input id="iipInput" name="nipInput" type="number" value="50">
  11. <progress id="iprProgress" name="nprProgress" value="50" max="100">
  12. <button name="nbtSender" value="../Html/exprogress.htm">ボタン</button>
  13. <br>受信用の<br>ページへ
  14. </form>
  15. </body>
  16. </html>

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

参照元
参照元
JSONデータ
JSON形式での、データのイメージです。
  1. {
  2. "progress": {
  3. "check": "2024-09-01",
  4. "group": "Form",
  5. "element": "- - (%Phrasing)* -(progress) -- progress indicator. (Normal elements.) [Flow|Phrasing|Labelable|Palpable] --",
  6. "attlist": {
  7. "%Global;": "",
  8. "value": "NUMBER #IMPLIED -- Current value of the element --",
  9. "max": "NUMBER 1.0 -- Upper bound of range --",
  10. },
  11. "comment": "進行状況インジケーター (progress indicator)",
  12. "point": "タスクの完了の進行状況を表します。進行状況は不確定であり、進行は進んでいるが、タスクが完了するまでにどれだけの作業が残っているかが不明である事を示しているか (タスクがリモートホストの応答を待っている為など)、進行状況が不明であるかのどちらかです。0 から最大までの範囲の数値で、これまでに完了した作業の割合を示します。",
  13. "kind": "Normal",
  14. "categories": [
  15. "Flow",
  16. "Phrasing",
  17. "Labelable",
  18. "Palpable",
  19. ],
  20. "used": "parent (%Phrasing)*",
  21. "contentmodel": "progress (%Phrasing)* -(progress)",
  22. "tag": [
  23. "-",
  24. "-",
  25. ],
  26. "attributes": {
  27. "value": "要素の現在値",
  28. "max": "範囲の上限",
  29. },
  30. "dominterface": "HTMLProgressElement",
  31. "rendering": "Form",
  32. "reference": [
  33. {
  34. "title": "HTML Living Standard. 4.10.13 The progress element.",
  35. "href": "https://html.spec.whatwg.org/multipage/form-elements.html#the-progress-element",
  36. "heading": "HTML Living Standard. 4.10.13 The progress element",
  37. "sub": "Last Updated 27 August 2024",
  38. },
  39. {
  40. "title": "HTML Living Standard. 15 Rendering 15.5.15 The progress element.",
  41. "href": "https://html.spec.whatwg.org/multipage/rendering.html#the-progress-element-2",
  42. "heading": "HTML Living Standard. 15 Rendering 15.5.15 The progress element",
  43. "sub": "Last Updated 27 August 2024",
  44. },
  45. {
  46. "title": "HTML 5.2 W3C Recommendation. 4.10.14 The progress element. W3C Recommendation, 14 December 2017.",
  47. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/sec-forms.html#the-progress-element",
  48. "heading": "HTML 5.2 W3C 勧告. 4.10.14 The progress element",
  49. "sub": "W3C勧告、2017年12月14日",
  50. },
  51. {
  52. "title": "HTML 5.2 W3C Recommendation. 10.5.13. The progress element.",
  53. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/rendering.html#the-progress-element-rendering",
  54. "heading": "HTML 5.2 W3C 勧告. 10.5.13. The progress element.",
  55. "sub": "W3C勧告、2017年12月14日",
  56. },
  57. {
  58. "title": "HTML 5.1 W3C Recommendation. 4.10.14. The progress element. W3C Recommendation, 1 November 2016.",
  59. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/sec-forms.html#the-progress-element",
  60. "heading": "HTML 5.1 W3C 勧告. 4.10.14. The progress element",
  61. "sub": "W3C勧告、2016年11月1日",
  62. },
  63. {
  64. "title": "HTML 5.1 W3C Recommendation. 10.5.13. The progress element. W3C Recommendation, 1 November 2016.",
  65. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/rendering.html#the-progress-element-rendering",
  66. "heading": "HTML 5.1 W3C 勧告. 10.5.13. The progress element.",
  67. "sub": "W3C勧告、2016年11月1日",
  68. },
  69. {
  70. "title": "HTML 5 W3C Recommendation. 4.10.14 The progress element. W3C Recommendation, 28 October 2014.",
  71. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/forms.html#the-progress-element",
  72. "heading": "HTML 5 W3C 勧告. 4.10.14 The progress element",
  73. "sub": "W3C勧告、2014年10月28日",
  74. },
  75. {
  76. "title": "HTML 5 W3C Recommendation. 10.5.12 The progress element. W3C Recommendation, 28 October 2014.",
  77. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/rendering.html#the-progress-element-0",
  78. "heading": "HTML 5 W3C 勧告. 10.5.12 The progress element.",
  79. "sub": "W3C勧告、2014年10月28日",
  80. },
  81. {
  82. "title": "MDN Web Docs. HTML <progress>: The Progress Indicator element.",
  83. "href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/progress",
  84. "heading": "<progress>: 進捗インジケーター要素 - HTML: ハイパーテキストマークアップ言語 | MDN",
  85. },
  86. ],
  87. "version": {
  88. "first": "HTML5",
  89. "latest": "HTML Living Standard",
  90. },
  91. }
  92. }

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

最終確認日

2024-09-01

2.使用可能な箇所

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

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

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

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

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

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

progress要素の子(内容・コンテンツ・Content)として、0 以上のフレージングコンテンツを配置できます。ただし、子孫にprogress要素があってはいけません。

フレージングコンテンツである要素(progress要素除く)は、script要素, noscript要素, template要素, input要素, textarea要素, select要素, label要素, button要素, output要素, meter要素, datalist要素, picture要素, object要素, img要素, iframe要素, embed要素, video要素, audio要素, canvas要素, map要素, area要素, a要素, ins要素, del要素, abbr要素, b要素, bdi要素, bdo要素, br要素, cite要素, code要素, data要素, dfn要素, em要素, i要素, kbd要素, mark要素, q要素, ruby要素, s要素, samp要素, small要素, span要素, strong要素, sub要素, sup要素, time要素, u要素, var要素, wbr要素, slot要素, text です。

4.属性

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

progressは、グローバル属性とvalue属性, max属性を設定できます。

  1. <label>進行状況の例示: <progress>不確定</progress></label>

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

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

value属性

  1. <progress value="0.7">0.7</progress>

valueは、タスクがどの程度完了したかを指定します。

valueとmaxが存在する場合、その値は有効な浮動小数点数である必要があります。valueが存在する場合、その値は 0 以上で、maxが存在する場合はその値以下、そうでない場合は 1.0 である必要があります。maxが存在する場合、その値は 0 より大きい必要があります。

valueが省略されている場合、プログレスバーは不確定プログレスバーになります。それ以外の場合は確定プログレスバーになります。

max属性

  1. <progress value="70" max="100">70 %</progress>

maxは、タスクに必要な作業の合計量を指定します。

valueとmaxが存在する場合、その値は有効な浮動小数点数である必要があります。valueが存在する場合、その値は 0 以上で、maxが存在する場合はその値以下、そうでない場合は 1.0 である必要があります。maxが存在する場合、その値は 0 より大きい必要があります。

valueが指定されてmaxが省略されている場合、確定プログレスバーの完了となる値は 1.0 になります。

5.Web API

id属性を用いて
getElementById()メソッドで
要素を取得する方法がお勧めです。

progress要素を表すプロパティはないので、idを用いて documentの getElementById()メソッドで、要素を取得する方法がお勧めです。この時に取得できるのはHTMLProgressElement オブジェクトです。

6.レンダリング

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

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

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

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

7.気を付ける点

カテゴリ

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

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

8.付記