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

caption要素

1.仕様

CAPTION要素は、
親である表(テーブル)の
見出し(タイトル)を
表します。

caption

表の見出し (table caption)

種類

通常要素

カテゴリ

なし

使用できるコンテキスト
table要素の最初

table要素の最初のコンテンツとして、使用できます。

コンテンツモデル
0個以上のフローコンテンツ (table要素 を除く)

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

table要素を除くフローコンテンツに分類される要素は、header要素, footer要素, main要素, address要素, ol要素, ul要素, menu要素, dl要素, form要素, fieldset要素, search要素, hr要素, p要素, pre要素, blockquote要素, figure要素, div要素, dialog要素, section要素, nav要素, aside要素, article要素, h1要素, h2要素, h3要素, h4要素, h5要素, h6要素, hgroup要素, script要素, noscript要素, template要素, input要素, textarea要素, select要素, label要素, button要素, output要素, progress要素, meter要素, datalist要素, picture要素, object要素, img要素, iframe要素, embed要素, video要素, audio要素, canvas要素, map要素, area要素, a要素, details要素, 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要素, テキスト です。

タグの省略
終了タグは省略できます。

caption要素の直後に ASCII 空白またはコメントが続かない場合は、caption要素の終了タグを省略できます。

コンテンツ属性

グローバル属性のみ

DOM インターフェイス
HTMLTableCaptionElement
  1. [Exposed=Window]
  2. interface HTMLTableCaptionElement : HTMLElement {
  3. [HTMLConstructor] constructor();
  4.  
  5. // also has obsolete members
  6. };
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
暗黙的="caption" ARIAロール="No" aria-* 属性="Global"

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

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

グローバル aria-* 属性が記述できます。

レンダリング
ブロックボックス
テーブル
  1. caption {
  2. display: table-caption;
  3. text-align: center;
  4. unicode-bidi: isolate;
  5. }
  6. caption[align=bottom i] { caption-side: bottom; }

CSS を大雑把に読むと、 テーブルラッパーボックスに関して特別な動作を持つブロックレベルのテーブルキャプションボックスを生成します。 などになります。

説明
caption要素は、親である表の見出しを表します。

caption要素は、親である表(テーブル・table)の見出し(タイトル)を表します。これによって表のコンテキストが紹介され、非常に理解しやすくなります。

  1. <!DOCTYPE html>
  2. <html lang="ja">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>caption要素の例 - (Example of caption element) | 離珠のHTMLでしぃ！</title>
  6. </head>
  7. <body>
  8. <h1>caption要素の例</h1>
  9. <table>
  10. <caption>caption要素の例</caption>
  11. <colgroup>
  12. <col>
  13. <col>
  14. <col>
  15. </colgroup>
  16. <thead>
  17. <tr>
  18. <th>id</th>
  19. <th>name</th>
  20. <th>data</th>
  21. </tr>
  22. </thead>
  23. <tbody>
  24. <tr>
  25. <td>10</td>
  26. <th>name01</th>
  27. <td>data01</td>
  28. </tr>
  29. <tr>
  30. <td>20</td>
  31. <th>name02</th>
  32. <td>data02</td>
  33. </tr>
  34. </tbody>
  35. <tbody>
  36. <tr>
  37. <td>55</td>
  38. <th>name55</th>
  39. <td>data55</td>
  40. </tr>
  41. <tr>
  42. <td>57</td>
  43. <th>name57</th>
  44. <td>data57</td>
  45. </tr>
  46. <tr>
  47. <td>59</td>
  48. <th>name59</th>
  49. <td>data59</td>
  50. </tr>
  51. </tbody>
  52. <tfoot>
  53. <tr>
  54. <td>-</td>
  55. <th>total</th>
  56. <td>data99</td>
  57. </tr>
  58. </tfoot>
  59. </table>
  60. </body>
  61. </html>

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

参照元
参照元
JSONデータ
JSON形式での、データのイメージです。
  1. {
  2. "caption": {
  3. "check": "2024-09-01",
  4. "group": "Table",
  5. "element": "- O (%Flow)* -(table) -- table caption. (Normal elements.) [None] --",
  6. "attlist": {"%Global;": ""},
  7. "comment": "表の見出し (table caption)",
  8. "point": "親である表の見出しを表します。",
  9. "description": "親である表(テーブル・table)の見出し(タイトル)を表します。これによって表のコンテキストが紹介され、非常に理解しやすくなります。",
  10. "kind": "Normal",
  11. "categories": "None",
  12. "used": "table (caption?,colgroup*,thead?,(tbody|tr)*,tfoot?)",
  13. "contentmodel": "caption (%Flow)* -(table)",
  14. "tag": [
  15. "-",
  16. "O",
  17. ],
  18. "tagsupplement": "caption要素の直後に ASCII 空白またはコメントが続かない場合は、caption要素の終了タグを省略できます。",
  19. "attributes": "Global",
  20. "dominterface": "HTMLTableCaptionElement",
  21. "rendering": [
  22. "Tables",
  23. "Bidirectional",
  24. ],
  25. "reference": [
  26. {
  27. "title": "HTML Living Standard. 4.9.2 The caption element.",
  28. "href": "https://html.spec.whatwg.org/multipage/tables.html#the-caption-element",
  29. "heading": "HTML Living Standard. 4.9.2 The caption element",
  30. "sub": "Last Updated 27 August 2024",
  31. },
  32. {
  33. "title": "HTML Living Standard. 15 Rendering 15.3.8 Tables.",
  34. "href": "https://html.spec.whatwg.org/multipage/rendering.html#tables-2",
  35. "heading": "HTML Living Standard. 15 Rendering 15.3.8 Tables",
  36. "sub": "Last Updated 27 August 2024",
  37. },
  38. {
  39. "title": "HTML 5.2 W3C Recommendation. 4.9.2 The caption element. W3C Recommendation, 14 December 2017.",
  40. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/tabular-data.html#the-caption-element",
  41. "heading": "HTML 5.2 W3C 勧告. 4.9.2 The caption element",
  42. "sub": "W3C勧告、2017年12月14日",
  43. },
  44. {
  45. "title": "HTML 5.2 W3C Recommendation. 10.3.9. Tables.",
  46. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/rendering.html#tables",
  47. "heading": "HTML 5.2 W3C 勧告. 10.3.9. Tables",
  48. "sub": "W3C勧告、2017年12月14日",
  49. },
  50. {
  51. "title": "HTML 5.1 W3C Recommendation. 4.9.2 The caption element. W3C Recommendation, 1 November 2016.",
  52. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/tabular-data.html#the-caption-element",
  53. "heading": "HTML 5.1 W3C 勧告. 4.9.2 The caption element",
  54. "sub": "W3C勧告、2016年11月1日",
  55. },
  56. {
  57. "title": "HTML 5.1 W3C Recommendation. 10.3.9. Tables. W3C Recommendation, 1 November 2016.",
  58. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/rendering.html#tables",
  59. "heading": "HTML 5.1 W3C 勧告. 10.3.9. Tables",
  60. "sub": "W3C勧告、2016年11月1日",
  61. },
  62. {
  63. "title": "HTML 5 W3C Recommendation. 4.9.2 The caption element. W3C Recommendation, 28 October 2014.",
  64. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/tabular-data.html#the-caption-element",
  65. "heading": "HTML 5 W3C 勧告. 4.9.2 The caption element",
  66. "sub": "W3C勧告、2014年10月28日",
  67. },
  68. {
  69. "title": "HTML 5 W3C Recommendation. 10.3.9 Tables. W3C Recommendation, 28 October 2014.",
  70. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/rendering.html#tables",
  71. "heading": "HTML 5 W3C 勧告. 10.3.9 Tables",
  72. "sub": "W3C勧告、2014年10月28日",
  73. },
  74. {
  75. "title": "HTML 4.01 Specification W3C Recommendation. 11.2.2 Table Captions: The CAPTION element. W3C Recommendation 24 December 1999.",
  76. "href": "https://www.w3.org/TR/html401/struct/tables.html#h-11.2.2",
  77. "heading": "HTML 4.01 Specification W3C 勧告. 11.2.2 Table Captions: The CAPTION element",
  78. "sub": "W3C勧告1999年12月24日",
  79. },
  80. {
  81. "title": "HTML 3.2 Reference Specification. W3C Recommendation 14-Jan-1997.",
  82. "href": "https://www.w3.org/TR/2018/SPSD-html32-20180315/",
  83. "heading": "HTML 3.2 Reference Specification",
  84. "sub": "W3C勧告1997年1月14日",
  85. },
  86. {
  87. "title": "MDN Web Docs. HTML <caption>: The Table Caption element.",
  88. "href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/caption",
  89. "heading": "<caption>: 表キャプション要素 - HTML: ハイパーテキストマークアップ言語 | MDN",
  90. },
  91. ],
  92. "version": {
  93. "first": "HTML3",
  94. "latest": "HTML Living Standard",
  95. },
  96. }
  97. }

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

最終確認日

2024-09-01

2.使用可能な箇所

table要素 に
配置できます。

caption要素を使用できる状態(コンテキスト・Context)は、 table要素の 1番目に配置できます。

表の下方に描画したい場合でも、table要素の最初の子要素として記述します。その上でスタイルシートで caption-side: bottom; と指定する事で、テーブルキャプションボックスを表(テーブル) (テーブルラッパーボックス) の下方に配置します。

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

table要素を除く
フローコンテンツを
配置できます。

caption要素の子(内容・コンテンツ・Content)として、table要素を除く フローコンテンツを配置できます。

table要素を除く フローコンテンツである要素は、header要素, footer要素, main要素, address要素, ol要素, ul要素, menu要素, dl要素, form要素, fieldset要素, search要素, hr要素, p要素, pre要素, blockquote要素, figure要素, div要素, dialog要素, slot要素, section要素, nav要素, aside要素, article要素, h1要素, h2要素, h3要素, h4要素, h5要素, h6要素, hgroup要素, script要素, noscript要素, template要素, input要素, textarea要素, select要素, label要素, button要素, output要素, progress要素, meter要素, datalist要素, picture要素, object要素, img要素, iframe要素, embed要素, video要素, audio要素, canvas要素, map要素, area要素, a要素, details要素, 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要素, text です。

table
caption
colgroup
thead
tbody
tfoot
Flow
col
tr
tr
tr
  1. <table>
  2. <caption>caption</caption>
  3. <colgroup>
  4. <col>
  5. <col>
  6. <col>
  7. </colgroup>
  8. <thead>
  9. <tr><th>id</th><th>name</th><th>data</th></tr>
  10. </thead>
  11. <tbody>
  12. <tr><td>10</td><th>name01</th><td>data01</td></tr>
  13. <tr><td>20</td><th>name02</th><td>data02</td></tr>
  14. </tbody>
  15. <tbody>
  16. <tr><td>55</td><th>name55</th><td>data55</td></tr>
  17. <tr><td>57</td><th>name57</th><td>data57</td></tr>
  18. <tr><td>59</td><th>name59</th><td>data59</td></tr>
  19. </tbody>
  20. <tfoot>
  21. <tr><td>-</th><th>total</th><td>data99</td></tr>
  22. </tfoot>
  23. </table>

caption要素のコンテンツの一部として、table要素を除く 0個以上の フローコンテンツを配置できます。

ブロック
フォーマット
コンテキスト
テーブル
キャプション
ボックス
テーブル
フォーマット
コンテキスト
テーブル
トラック
グループ
ボックス
テーブル
トラック
ボックス
ブロック
コンテナ
ボックス

ボックスで表すと、table要素が存在して、その中に caption要素とテーブルグリッドボックスがあります。

table要素は、ブロックレベルのブロックコンテナであるボックス(テーブルラッパーボックス)を生成します。table要素を含むブロックフォーマットコンテキストがない場合は、新しいブロックフォーマットコンテキストを確立します。table要素は、ブロックレベルのボックスを生成するcaption要素を配置します。他の要素はテーブルグリッドボックス内に収めます。なのでここでは、インラインフォーマットコンテキストは確立されません。
尚、この説明は各要素のレンダリングに関する指定が既定値での話で、個々にスタイルを指定した場合はこの限りではありません。

表の下方に描画したい場合は、スタイルシートで caption-side: bottom; と指定する事で、テーブルキャプションボックスを表(テーブル) (テーブルラッパーボックス) の下方に配置します。

4.属性

グローバル属性のみ、
設定できます。

caption要素は、グローバル属性のみ 設定できます。

5.Web API

table要素の
captionプロパティは、
テーブルの
キャプション要素を
返します。

table要素を id属性を用いて documentの getElementById()メソッドで、要素を取得する方法がお勧めです。この時に取得できるのはHTMLTableElement オブジェクトです。そのプロパティである captionプロパティが、テーブルのキャプション要素を表します。この時に取得できるのはHTMLTableCaptionElement オブジェクトです。

6.レンダリング

  1. caption {
  2. display: table-caption;
  3. text-align: center;
  4. unicode-bidi: isolate;
  5. }

caption要素は、ブロックレベルのブロックコンテナであるテーブルキャプションボックスを生成します。

ブロックフォーマットコンテキストに参加して、ブロックフォーマットコンテキストを継承, 確立します。

caption
10name01data01
20name02data02
  1. <table style="border-collapse: ;
    border-spacing: px; border: ;
    border-left: ;
    border-image: ;
    border-radius: em em em em;
    box-shadow: ;"
    class="">
  2. <caption style="caption-side: ;
    border-style: ;
    border-width: px;
    border-radius: em em em em;
    box-shadow: ;">caption</caption>
  3. <tbody>
  4. <tr><td>10</td><th>name01</th><td>data01</td></tr>
  5. <tr><td>20</td><th>name02</th><td>data02</td></tr>
  6. </tbody>
  7. </table>

caption要素の装飾例です。例示で分かり易くする為に、別途にセルの境界線の装飾を指定できる様にしています。

とりあえず詰め込んだ例示なので、組み合わせによっては効果のない物もあります。またスクリプトにて動的に処理している為、指定する順番で効果が異なる可能性もあります。
実際に使用する場合は、動作確認を改めて行ってから採用して下さい。

7.気を付ける点

位置

記述する位置は、table要素の 1番目に配置できます。そして描画する位置は、caption-side: top という既定値で表(テーブル)の上方に配置します。ここで注意点は、table要素の描画するボックスの外にcaption要素が位置するという事です。caption-side: bottom と指定すると、表(テーブル)の下方に配置します。これもtable要素の描画するボックスの外です。

使用できる状態

table要素の最初の子要素として使用できます。つまりtable要素に１つだけ用いる事が出来るという事です。２つは出来ません。
表(テーブル)の上方と下方の両方にcaption要素の様な記述をしたい場合は、装飾用にtable要素を含む要素 (div要素など) を用いる必要があります。この時のこの含む要素の用途, 目的は、幅を合わせる為のものです。幅が固定(事前に指定できる)ならば、単純に前後にcaption要素の代用のdiv要素を配置して表せば済みます。

8.付記