1.仕様
CAPTION要素は、
親である表(テーブル)の
見出し(タイトル)を
表します。
CAPTION - O (%Flow)* -(table) -- table caption. (Normal elements.) [None] --
- 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
[Exposed=Window]
interface HTMLTableCaptionElement : HTMLElement {
[HTMLConstructor] constructor();
// also has obsolete members
};
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
-
暗黙的="
caption
" ARIAロール="No
" aria-* 属性="Global
"暗黙的な ARIAセマンティクスは、
role=caption
です。作成者は、暗黙的な ARIAセマンティクス, または HTML要素のネイティブセマンティクスを上書きしてはいけません。
グローバル aria-* 属性が記述できます。
- レンダリング
- ブロック
ボックス テーブル
caption {
display: table-caption;
text-align: center;
unicode-bidi: isolate;
}
caption[align=bottom i] {
caption-side: bottom;
}
CSS を大雑把に読むと、 テーブルラッパーボックスに関して特別な動作を持つブロックレベルのテーブルキャプションボックスを生成します。 などになります。
- 説明
-
caption
要素 は、親である表の見出しを表します。caption
要素 は、親である表(テーブル・table)の見出し(タイトル)を表します。これによって表のコンテキストが紹介され、非常に理解しやすくなります。<!DOCTYPE html>
<html lang=
"ja"> <head>
<meta charset=
"utf-8"> <title>
caption要素の例 - (Example of caption element) | 離珠のHTMLでしぃ!</title> </head>
<body>
<h1>
caption要素の例</h1> <table>
<caption>
caption要素の例</caption> <colgroup>
<col>
<col>
<col>
</colgroup>
<thead>
<tr>
<th>
id</th> <th>
name</th> <th>
data</th> </tr>
</thead>
<tbody>
<tr>
<td>
10</td> <th>
name01</th> <td>
data01</td> </tr>
<tr>
<td>
20</td> <th>
name02</th> <td>
data02</td> </tr>
</tbody>
<tbody>
<tr>
<td>
55</td> <th>
name55</th> <td>
data55</td> </tr>
<tr>
<td>
57</td> <th>
name57</th> <td>
data57</td> </tr>
<tr>
<td>
59</td> <th>
name59</th> <td>
data59</td> </tr>
</tbody>
<tfoot>
<tr>
<td>
-</td> <th>
total</th> <td>
data99</td> </tr>
</tfoot>
</table>
</body>
</html>
このサンプルへのリンクです。
(./excaption.htm) - 参照元
-
参照元
- HTML Living Standard. 4.9.2 The caption element (Last Updated 27 August 2024)
- HTML Living Standard. 15 Rendering 15.3.8 Tables (Last Updated 27 August 2024)
- HTML 5.2 W3C 勧告. 4.9.2 The caption element (W3C勧告、2017年12月14日)
- HTML 5.2 W3C 勧告. 10.3.9. Tables (W3C勧告、2017年12月14日)
- HTML 5.1 W3C 勧告. 4.9.2 The caption element (W3C勧告、2016年11月1日)
- HTML 5.1 W3C 勧告. 10.3.9. Tables (W3C勧告、2016年11月1日)
- HTML 5 W3C 勧告. 4.9.2 The caption element (W3C勧告、2014年10月28日)
- HTML 5 W3C 勧告. 10.3.9 Tables (W3C勧告、2014年10月28日)
- HTML 4.01 Specification W3C 勧告. 11.2.2 Table Captions: The CAPTION element (W3C勧告1999年12月24日)
- HTML 3.2 Reference Specification (W3C勧告1997年1月14日)
- <caption>: 表キャプション要素 - HTML: ハイパーテキストマークアップ言語 | MDN
- JSONデータ
-
JSON形式での、データのイメージです。
{
"caption": {
"check": "2024-09-01",
"group": "Table",
"element": "- O (%Flow)* -(table) -- table caption. (Normal elements.) [None] --",
"attlist": {"%Global;": ""},
"comment": "表の見出し (table caption)",
"point": "親である表の見出しを表します。",
"description": "親である表(テーブル・table)の見出し(タイトル)を表します。これによって表のコンテキストが紹介され、非常に理解しやすくなります。",
"kind": "Normal",
"categories": "None",
"used": "table (caption?,colgroup*,thead?,(tbody|tr)*,tfoot?)",
"contentmodel": "caption (%Flow)* -(table)",
"tag": [
"-",
"O",
],
"tagsupplement": "caption要素の直後に ASCII 空白またはコメントが続かない場合は、caption要素の終了タグを省略できます。",
"attributes": "Global",
"dominterface": "HTMLTableCaptionElement",
"rendering": [
"Tables",
"Bidirectional",
],
"reference": [
{
"title": "HTML Living Standard. 4.9.2 The caption element.",
"href": "https://html.spec.whatwg.org/multipage/tables.html#the-caption-element",
"heading": "HTML Living Standard. 4.9.2 The caption element",
"sub": "Last Updated 27 August 2024",
},
{
"title": "HTML Living Standard. 15 Rendering 15.3.8 Tables.",
"href": "https://html.spec.whatwg.org/multipage/rendering.html#tables-2",
"heading": "HTML Living Standard. 15 Rendering 15.3.8 Tables",
"sub": "Last Updated 27 August 2024",
},
{
"title": "HTML 5.2 W3C Recommendation. 4.9.2 The caption element. W3C Recommendation, 14 December 2017.",
"href": "https://www.w3.org/TR/2017/REC-html52-20171214/tabular-data.html#the-caption-element",
"heading": "HTML 5.2 W3C 勧告. 4.9.2 The caption element",
"sub": "W3C勧告、2017年12月14日",
},
{
"title": "HTML 5.2 W3C Recommendation. 10.3.9. Tables.",
"href": "https://www.w3.org/TR/2017/REC-html52-20171214/rendering.html#tables",
"heading": "HTML 5.2 W3C 勧告. 10.3.9. Tables",
"sub": "W3C勧告、2017年12月14日",
},
{
"title": "HTML 5.1 W3C Recommendation. 4.9.2 The caption element. W3C Recommendation, 1 November 2016.",
"href": "https://www.w3.org/TR/2016/REC-html51-20161101/tabular-data.html#the-caption-element",
"heading": "HTML 5.1 W3C 勧告. 4.9.2 The caption element",
"sub": "W3C勧告、2016年11月1日",
},
{
"title": "HTML 5.1 W3C Recommendation. 10.3.9. Tables. W3C Recommendation, 1 November 2016.",
"href": "https://www.w3.org/TR/2016/REC-html51-20161101/rendering.html#tables",
"heading": "HTML 5.1 W3C 勧告. 10.3.9. Tables",
"sub": "W3C勧告、2016年11月1日",
},
{
"title": "HTML 5 W3C Recommendation. 4.9.2 The caption element. W3C Recommendation, 28 October 2014.",
"href": "https://www.w3.org/TR/2014/REC-html5-20141028/tabular-data.html#the-caption-element",
"heading": "HTML 5 W3C 勧告. 4.9.2 The caption element",
"sub": "W3C勧告、2014年10月28日",
},
{
"title": "HTML 5 W3C Recommendation. 10.3.9 Tables. W3C Recommendation, 28 October 2014.",
"href": "https://www.w3.org/TR/2014/REC-html5-20141028/rendering.html#tables",
"heading": "HTML 5 W3C 勧告. 10.3.9 Tables",
"sub": "W3C勧告、2014年10月28日",
},
{
"title": "HTML 4.01 Specification W3C Recommendation. 11.2.2 Table Captions: The CAPTION element. W3C Recommendation 24 December 1999.",
"href": "https://www.w3.org/TR/html401/struct/tables.html#h-11.2.2",
"heading": "HTML 4.01 Specification W3C 勧告. 11.2.2 Table Captions: The CAPTION element",
"sub": "W3C勧告1999年12月24日",
},
{
"title": "HTML 3.2 Reference Specification. W3C Recommendation 14-Jan-1997.",
"href": "https://www.w3.org/TR/2018/SPSD-html32-20180315/",
"heading": "HTML 3.2 Reference Specification",
"sub": "W3C勧告1997年1月14日",
},
{
"title": "MDN Web Docs. HTML <caption>: The Table Caption element.",
"href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/caption",
"heading": "<caption>: 表キャプション要素 - HTML: ハイパーテキストマークアップ言語 | MDN",
},
],
"version": {
"first": "HTML3",
"latest": "HTML Living Standard",
},
}
}
注意: 簡易に描画する為に、各項目の後ろに
,
を付与しています。JSON の形式では、末尾の項目の後には,
は付けません。 - 最終確認日
-
2024-09-01
2.使用できるコンテキスト
caption要素は、
table要素に
使用できます。
<caption>
<table>
<caption>
見出し</caption> <tbody>
<tr>
<th>
セルB11</th> <td>
セルB12</td> </tr>
</tbody>
</table>
<table>
3.コンテンツモデル
caption要素は、
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>
要素 - テキスト
content
<table>
<caption>
<p> 見出し</p></caption> <tbody>
<tr>
<th>
セルB11</th> <td>
セルB12</td> </tr>
</tbody>
</table>
<caption>
フォーマット
コンテキスト
キャプション
ボックス
フォーマット
コンテキスト
トラック
グループ
ボックス
トラック
ボックス
コンテナ
ボックス
ボックスで表すと、table
table
尚、この説明は各要素のレンダリングに関する指定が既定値での話で、個々にスタイルを指定した場合はこの限りではありません。
表の下方に描画したい場合は、スタイルシートで caption-side
: bottom
; と指定する事で、テーブル
4.コンテンツ属性
caption要素は、
グローバル属性のみ、
設定できます。
<caption>
5.DOM インターフェイス
table要素の
captionプロパティは、
テーブルの
キャプション要素を
返します。
table
6.アクセシビリティ
caption要素は、
図、表、グリッド、
またはツリーグリッドの
名前、および説明を表す
可視コンテンツです。
<caption>role
となります。
`caption` ロールは、次のようなランド
図、表、グリッド、またはツリー
キャプションを使用する場合、作成者は以下の点を確認する必要があります。
キャプションは、図、表、グリッド、またはツリー
キャプションは、表、グリッド、またはツリー
キャプションは、図の最初または最後の子要素です。
作成者は、親の図、表、グリッド、またはツリー
作成者が<caption>
「役割なし」: 作成者は暗黙的な ARIA セマンティクスまたは HTML 要素のネイティブ セマンティクスを上書きしてはならないことを表します。
命名禁止として識別される要素は、作成者がaria-label
それ以外の場合は、グローバル
7.レンダリング
caption {
display: table-caption;
text-align: center;
unicode-bidi: isolate;
}
caption
ブロック
10 | name01 | data01 |
---|---|---|
20 | name02 | data02 |
<table style=
"border-collapse: ;
border-spacing: px; border: ;
border-left: ;
border-image: ;
border-radius: em em em em;
box-shadow: ;"
class=""> <caption style=
"caption-side: ;
border-style: ;
border-width: px;
border-radius: em em em em;
box-shadow: ;">caption</caption><tbody>
<tr>
<td> 10 </td> <th> name01 </th> <td> data01 </td> </tr> <tr>
<td> 20 </td> <th> name02 </th> <td> data02 </td> </tr> </tbody>
</table>
caption
とりあえず詰め込んだ例示なので、組み合わせによっては効果のない物もあります。またスクリプトにて動的に処理している為、指定する順番で効果が異なる可能性もあります。
実際に使用する場合は、動作確認を改めて行ってから採用して下さい。
8.気を付ける点
位置
記述する位置は、tablecaption-side
: top
という既定値で表(テーブル)の上方に配置します。ここで注意点は、tablecaption-side
: bottom
と指定すると、表(テーブル)の下方に配置します。これもtable
使用できる状態
table
表(テーブル)の上方と下方の両方にcaption