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

output要素


1.仕様

OUTPUT要素は、
アプリケーションによって
実行された計算の結果、
またはユーザーの
アクションの結果を
表します。

output

出力 (output)

種類

通常要素

カテゴリ

タグの省略

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

コンテンツ属性
グローバル属性 他
for属性
出力の計算元となったコントロールを指定します
form属性
要素をフォーム要素に関連付けます
name属性
form.elements API で使用する要素の名前。
DOM インターフェイス
HTMLOutputElement
  1. [Exposed=Window]
  2. interface HTMLOutputElement : HTMLElement {
  3. [HTMLConstructor] constructor();
  4.  
  5. [SameObject, PutForwards=value] readonly attribute DOMTokenList htmlFor;
  6. readonly attribute HTMLFormElement? form;
  7. [CEReactions] attribute DOMString name;
  8.  
  9. readonly attribute DOMString type;
  10. [CEReactions] attribute DOMString defaultValue;;
  11. [CEReactions] attribute DOMString value;
  12.  
  13. readonly attribute boolean willValidate;
  14. readonly attribute ValidityState validity;
  15. readonly attribute DOMString validationMessage;
  16. boolean checkValidity();
  17. boolean reportValidity();
  18. undefined setCustomValidity(DOMString error);
  19.  
  20. readonly attribute NodeList labels;
  21. };
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
暗黙的="status" ARIAロール="任意" aria-* 属性="GlobalAny"

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

要素で任意の role 値を使用できます。ただし、作成者が要素の暗黙的なロール, 汎用ロール, または ARIA によって非推奨となったロールをこれらの要素に対して指定することは推奨されません。

グローバル aria-* 属性と、許可されたロールに適用される任意の aria-* 属性が記述できます。

レンダリング
インラインレベルボックス
フォームコントロール
  1. output {
  2. unicode-bidi: isolate;
  3. }

CSS を大雑把に読むと、 フローレイアウトに配置されたときにインラインレベルのボックス(インラインボックス)を生成します。 などになります。

説明
output要素は、アプリケーションによって実行された計算の結果、またはユーザーのアクションの結果を表します。
  1. <!DOCTYPE html>
  2. <html lang="ja">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>output要素の例 - (Example of output element) | 離珠のHTMLでしぃ!</title>
  6. </head>
  7. <body>
  8. <h1>output要素の例</h1>
  9. <form action="../Html/fmreceive.htm" oninput="nouOutput.value = nipInput01.valueAsNumber + nipInput02.valueAsNumber;">
  10. <input id="iipInput01" name="nipInput01" type="number" value="1">
  11. +
  12. <input id="iipInput02" name="nipInput02" type="number" value="2">
  13. =
  14. <output name="nouOutput" for="iipInput01 iipInput02">3</output>

  15. <button name="nbtSender" value="../Html/exoutput.htm">ボタン</button>
  16. <br>受信用の<br>ページへ
  17. </form>
  18. </body>
  19. </html>

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

JSONデータ
JSON形式での、データのイメージです。
  1. {
  2. "output": {
  3. "check": "2024-09-01",
  4. "group": "Form",
  5. "element": "- - (%Phrasing)* -- output. (Normal elements.) [Flow|Phrasing|Listed|Labelable|Resettable|Autocapitalize|Form|Palpable] --",
  6. "attlist": {
  7. "%Global;": "",
  8. "for": "IDREFS #IMPLIED -- Specifies controls from which the output was calculated --",
  9. "form": "IDREF #IMPLIED -- Associates the element with a form element --",
  10. "name": "CDATA #IMPLIED -- Name of the element to use in the form.elements API. --",
  11. },
  12. "comment": "出力 (output)",
  13. "point": "アプリケーションによって実行された計算の結果、またはユーザーのアクションの結果を表します。",
  14. "kind": "Normal",
  15. "categories": [
  16. "Flow",
  17. "Phrasing",
  18. "Listed",
  19. "Labelable",
  20. "Resettable",
  21. "Autocapitalize",
  22. "Formassociated",
  23. "Palpable",
  24. ],
  25. "used": "parent (%Phrasing)*",
  26. "contentmodel": "output (%Phrasing)*",
  27. "tag": [
  28. "-",
  29. "-",
  30. ],
  31. "attributes": {
  32. "for": "出力の計算元となったコントロールを指定します",
  33. "form": "要素をフォーム要素に関連付けます",
  34. "name": "form.elements API で使用する要素の名前。",
  35. },
  36. "dominterface": "HTMLOutputElement",
  37. "rendering": [
  38. "Form",
  39. "Bidirectional",
  40. ],
  41. "reference": [
  42. {
  43. "title": "HTML Living Standard. 4.10.12 The output element.",
  44. "href": "https://html.spec.whatwg.org/multipage/form-elements.html#the-output-element",
  45. "heading": "HTML Living Standard. 4.10.12 The output element",
  46. "sub": "Last Updated 27 August 2024",
  47. },
  48. {
  49. "title": "HTML 5.2 W3C Recommendation. 4.10.12 The output element. W3C Recommendation, 14 December 2017.",
  50. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/sec-forms.html#the-output-element",
  51. "heading": "HTML 5.2 W3C 勧告. 4.10.6 The output element",
  52. "sub": "W3C勧告、2017年12月14日",
  53. },
  54. {
  55. "title": "HTML 5.1 W3C Recommendation. 4.10.13 The output element. W3C Recommendation, 1 November 2016.",
  56. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/sec-forms.html#the-output-element",
  57. "heading": "HTML 5.1 W3C 勧告. 4.10.13 The output element",
  58. "sub": "W3C勧告、2016年11月1日",
  59. },
  60. {
  61. "title": "HTML 5 W3C Recommendation. 4.10.13 The output element. W3C Recommendation, 28 October 2014.",
  62. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/forms.html#the-output-element",
  63. "heading": "HTML 5 W3C 勧告. 4.10.13 The output element",
  64. "sub": "W3C勧告、2014年10月28日",
  65. },
  66. {
  67. "title": "MDN Web Docs. HTML <output>: The Output element.",
  68. "href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/output",
  69. "heading": "<output>: 出力要素 - HTML: ハイパーテキストマークアップ言語 | MDN",
  70. },
  71. ],
  72. "version": {
  73. "first": "HTML5",
  74. "latest": "HTML Living Standard",
  75. },
  76. }
  77. }

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

最終確認日

2024-09-01


2.使用可能な箇所

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

output要素を使用できる状態(コンテキストContext)は、フレージングコンテンツを受け入れる要素に配置できます。

フレージングコンテンツを受け入れる要素は、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要素 です。

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


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

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


4.属性

グローバル属性と、
for,
form,
name を
設定できます。

outputは、グローバル属性for属性, form属性, name属性を設定できます。

  1. <form action="./fmreceive.htm" oninput="nouOutput.value = nipInput01.valueAsNumber + nipInput02.valueAsNumber">
  2. <input id="iipInput401" name="nipInput01" type="number" value="1"> +
  3. <input id="iipInput402" name="nipInput02" type="number" value="2"> =
  4. <output name="nouOutput" for="iipInput401 iipInput402">3</output>
  5. <button name="nbtSender" value="./fooutput.htm#MAP4NEXT">ボタン</button>
  6. </form>

form要素を改めて提示していない限り、この雛型の 4 行目のoutput要素の開始タグを置き換えてデモとしています。

idの値に関しては、1 文書で一意である必要がある為に、各デモで適切に書き換えています。

button要素valueの値は、作成者の決め事によりその都度送信元が分かる様に書き換えています。nameの値は、作成者の決め事によりnbtSenderで固定です。

+ = 3

for属性

  1. <output name="nouOutput" for="iipInput411 iipInput412">

for コンテンツ属性を使用すると、計算の結果と、計算に使用された値または計算に影響を与えた値を表す要素との間に明示的な関係を作成できます。forが指定されている場合、その属性には、順序付けられていないスペースで区切られた一意のトークンのセットで構成される文字列が含まれている必要があります。トークンはどれも他のトークンと同じではなく、それぞれが同じツリー内の要素の ID の値を持っている必要があります。

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

+ = 3

form属性

  1. <form id="ifoForm841" action="./fmreceive.htm" oninput="this.nouOutput.value = this.nipInput01.valueAsNumber + this.nipInput02.valueAsNumber">
  2. <button name="nbtSender" value="./fooutput.htm#MH3FORM">ボタン</button>
  3. <input id="iipInput421" name="nipInput01" type="number" value="1"> +
  4. <input id="iipInput422" name="nipInput02" type="number" value="2"> =
  5. </form>
  6. <form action="./fmreceive.htm">
  7. = <output name="nouOutput" for="iipInput421 iipInput422" form="ifoForm841">
  8. <button name="nbtSender" value="./fooutput.htm#MH3FORM">ボタン</button>
  9. </form>

formは、入力要素をそのフォーム所有者に明示的に関連付ける為に使用されます。

フォーム関連要素は、デフォルトでは、最も近い祖先form要素に関連付けられます。ただし、リストされている場合は、これを上書きする為にformを指定できます。つまりformを指定してフォーム所有者に関連付けした場合は、その要素の最も近い祖先への関連付けは上書きされるという事で、複数のフォーム所有者に関連付ける事は出来ないという事です。

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

+
= 3

name属性

  1. <output name="nouOutput" for="iipInput431 iipInput432">

nameは、要素の名前を表します。

nameは、フォームの送信時やformの elements オブジェクトで使用されるフォームコントロールの名前を指定します。属性が指定されている場合、その値は空の文字列またはisindexであってはなりません。
isindex以外では、name に空でない任意の値が許可されます。name_charset_の ASCII 大文字と小文字を区別しない一致は特別です。valueのない Hidden コントロールの名前として使用した場合、送信時にvalueに送信文字エンコーディングで構成される値が自動的に与えられます。

nameはフォームコントロールの名前となるので、他の属性名などと重複しないように命名規則を事前に内部規則などで決めておくのが良いです。

outputformコンテンツではあるが、送信可能な要素ではないので、フォームの送信時(送信先)の事は考慮対象にする必要はないでしょう。

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

+ = 3

5.Web API

name属性を用いて
form要素
(HTMLFormElement
オブジェクト)の
プロパティとして
要素を取得する方法が
お勧めです。

output要素単体を表すプロパティはないですが、まずform要素を取得して、nameの属性値を名称とするそれのプロパティとして要素を取得する方法がお勧めです。 理由は、他のformコンテンツがその名称が送信時のデータ名ともなり分かり易いという理由でこの方法を採用する事が考えられるので、それに合わせる方が良いと思うからです。 なにより、formコンテンツを用いるのなら、そのフォーム所有者を意識した方が良いでしょう。

  1. <form action="./fmreceive.htm" oninput="this.nouOutput.value = this.nipInput8511.valueAsNumber + this.nipInput8512.valueAsNumber">
  2. <input id="iipInput511" name="nipInput8511" type="number" value="1"> +
  3. <input id="iipInput512" name="nipInput8512" type="number" value="2"> =
  4. <output name="nouOutput" for="iipInput511 iipInput512">3</output>
  5. <button name="nbtSender" value="./fooutput.htm#MAP5NEXT">ボタン</button>
  6. </form>

output要素に値を設定する例です。

value IDL属性を用いて値を設定している理由は、textContent などでコンテンツ自体を書き換えてしまうと、リセット機能で戻す事が出来なくなる為です。output要素リセット可能な要素なので、その効果が有効な様に、value IDL属性を用いて値を設定しています。

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

+ = 3

6.レンダリング

レンダリングについて
スタイルシートでの
仕様での提案は
特にないようです。

output要素は、formコンテンツリセット可能な要素である機能が提示されているだけで、output要素自体のレンダリングに関してのスタイルシートでの提案はないようです。

リセット可能な要素の機能から察するに、コンテンツが描画されているのではなくて、コンテンツを既定値とした要素の値が描画されている様に思います。

displayプロパティの既定値はinlineですので、「フローレイアウトに配置されたときにインラインレベルのボックス(インラインボックス)を生成します。」となります。


7.気を付ける点

カテゴリ

リセット可能な要素でありformコンテンツでもあるが送信可能な要素ではありません。

output要素(内容コンテンツContent)として、0 以上のフレージングコンテンツを配置できます。ただしこの要素は、アプリケーションによって実行された計算の結果、またはユーザーのアクションの結果を表します。つまり凝ったコンテンツを配置しても、置き換えられてしまうという事です。 というか、凝った事をしたい場合は、スクリプトでリセット等も行う事にしてspan要素などを用いた方が良いかもしれません。


8.付記