1.仕様
TABLE要素は、
複数のディメンションを
持つデータを
表の形式で表します。
- table
-
表 (table element)
- 種類
-
通常要素
- コンテンツモデル
-
0または1つのcaption
要素 と、それに続く0個以上のcolgroup要素 と、それに続く0または1つのthead要素 と、それに続くtbody要素 またはtr要素 と、それに続く0または1つのtfoot要素 オプションでスクリプトをサポートする要素 が混在0または1つのcaption
要素 と、それに続く0個以上のcolgroup要素 と、それに続く0または1つのthead要素 と、それに続くtbody要素 またはtr要素 と、それに続く0または1つのtfoot要素 が配置できます。オプションで、スクリプトをサポートする要素 を混在して配置できます。スクリプトを
サポートする要素 に分類される要素は、script要素 , template要素 です。 - タグの省略
-
どちらのタグも省略できません。
- コンテンツ属性
-
グローバル属性のみ
- DOM インターフェイス
-
HTMLTableElement
[Exposed=Window]
interface HTMLTableElement : HTMLElement {
[HTMLConstructor] constructor();
[CEReactions] attribute HTMLTableCaptionElement? caption;
HTMLTableCaptionElement createCaption();
[CEReactions] undefined deleteCaption();
[CEReactions] attribute HTMLTableSectionElement? tHead;
HTMLTableSectionElement createTHead();
[CEReactions] undefined deleteTHead();
[CEReactions] attribute HTMLTableSectionElement? tFoot;
HTMLTableSectionElement createTFoot();
[CEReactions] undefined deleteTFoot();
[SameObject] readonly attribute HTMLCollection tBodies;
HTMLTableSectionElement createTBody();
[SameObject] readonly attribute HTMLCollection rows;
HTMLTableRowElement insertRow(optional long index = -1);
[CEReactions] undefined deleteRow(long index);
// 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
-
暗黙的="
table
" ARIAロール="任意" aria-* 属性="GlobalAny
"暗黙的な ARIAセマンティクスは、
role=table
です。要素で任意の role 値を使用できます。ただし、作成者が要素の暗黙的なロール, 汎用ロール, または ARIA によって非推奨となったロールをこれらの要素に対して指定することは推奨されません。
グローバル aria-* 属性と、許可されたロールに適用される任意の aria-* 属性が記述できます。
- レンダリング
- ブロック
ボックス テーブル
table {
display: table;
box-sizing: border-box;
border-spacing: 2px;
border-collapse: separate;
text-indent: initial;
unicode-bidi: isolate;
}
table[align=left i] { float: left; }
table[align=right i] { float: right; }
table[align=center i] { margin-inline: auto; }
table[rules=none i], table[rules=groups i], table[rules=rows i], table[rules=cols i], table[rules=all i] {
border-style: hidden;
border-collapse: collapse;
}
table[border] { border-style: outset; }
table[frame=void i] { border-style: hidden; }
table[frame=above i] { border-style: outset hidden hidden hidden; }
table[frame=below i] { border-style: hidden hidden outset hidden; }
table[frame=hsides i] { border-style: outset hidden outset hidden; }
table[frame=lhs i] { border-style: hidden hidden hidden outset; }
table[frame=rhs i] { border-style: hidden outset hidden hidden; }
table[frame=vsides i] { border-style: hidden outset; }
table[frame=box i], table[frame=border i] { border-style: outset; }
CSS を大雑把に読むと、 ブロックレベルのテーブルラッパーボックスを生成します。 などになります。
- 説明
-
table
要素 は、複数の次元を持つデータを、表の形式で表します。table
要素 は、複数のディメンションを持つデータを表(テーブル・table)の形式で表します。
ここでの表すとは、表形式の描画の比重が大きいのでその点を意識した方が良いと思います。<!DOCTYPE html>
<html lang=
"ja"> <head>
<meta charset=
"utf-8"> <title>table要素の例 - (Example of table element) | 離珠のHTMLでしぃ!</title>
</head>
<body>
<h1>table要素の例</h1>
<table>
<caption>table要素の例</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>
このサンプルへのリンクです。
(./extable.htm) - 参照元
-
参照元
- HTML Living Standard. 4.9.1 The table 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.1 The table element (W3C勧告、2017年12月14日)
- HTML 5.2 W3C 勧告. 10.3.9. Tables (W3C勧告、2017年12月14日)
- HTML 5.1 W3C 勧告. 4.9.1 The table element (W3C勧告、2016年11月1日)
- HTML 5.1 W3C 勧告. 10.3.9. Tables (W3C勧告、2016年11月1日)
- HTML 5 W3C 勧告. 4.9.1 The table element (W3C勧告、2014年10月28日)
- HTML 5 W3C 勧告. 10.3.9 Tables (W3C勧告、2014年10月28日)
- HTML 4.01 Specification W3C 勧告. 11.2.1 The TABLE element (W3C勧告1999年12月24日)
- HTML 3.2 Reference Specification (W3C勧告1997年1月14日)
- <table>: 表要素 - HTML: ハイパーテキストマークアップ言語 | MDN
- JSONデータ
-
JSON形式での、データのイメージです。
{
"table": {
"check": "2024-09-01",
"group": "Table",
"element": "- - (caption?,colgroup*,thead?,(tbody|tr)*,tfoot?) +(%Scriptsupporting) -- table element. (Normal elements.) [Flow|Palpable] --",
"attlist": {"%Global;": ""},
"comment": "表 (table element)",
"point": "複数の次元を持つデータを、表の形式で表します。",
"description": [
"複数のディメンションを持つデータを表(テーブル・table)の形式で表します。",
"ここでの表すとは、表形式の描画の比重が大きいのでその点を意識した方が良いと思います。",
],
"kind": "Normal",
"categories": [
"Flow",
"Palpable",
],
"used": "parent (%Flow)*",
"contentmodel": "table (caption?,colgroup*,thead?,(tbody|tr)*,tfoot?) +(%Scriptsupporting)",
"tag": [
"-",
"-",
],
"attributes": "Global",
"dominterface": "HTMLTableElement",
"rendering": [
"Tables",
"Bidirectional",
],
"reference": [
{
"title": "HTML Living Standard. 4.9.1 The table element.",
"href": "https://html.spec.whatwg.org/multipage/tables.html#the-table-element",
"heading": "HTML Living Standard. 4.9.1 The table 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.1 The table element. W3C Recommendation, 14 December 2017.",
"href": "https://www.w3.org/TR/2017/REC-html52-20171214/tabular-data.html#the-table-element",
"heading": "HTML 5.2 W3C 勧告. 4.9.1 The table 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.1 The table element. W3C Recommendation, 1 November 2016.",
"href": "https://www.w3.org/TR/2016/REC-html51-20161101/tabular-data.html#the-table-element",
"heading": "HTML 5.1 W3C 勧告. 4.9.1 The table 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.1 The table element. W3C Recommendation, 28 October 2014.",
"href": "https://www.w3.org/TR/2014/REC-html5-20141028/tabular-data.html#the-table-element",
"heading": "HTML 5 W3C 勧告. 4.9.1 The table 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.1 The TABLE element. W3C Recommendation 24 December 1999.",
"href": "https://www.w3.org/TR/html401/struct/tables.html#h-11.2.1",
"heading": "HTML 4.01 Specification W3C 勧告. 11.2.1 The TABLE 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 <table>: The Table element.",
"href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/table",
"heading": "<table>: 表要素 - HTML: ハイパーテキストマークアップ言語 | MDN",
},
],
"version": {
"first": "HTML3",
"latest": "HTML Living Standard",
},
}
}
注意: 簡易に描画する為に、各項目の後ろに
,
を付与しています。JSON の形式では、末尾の項目の後には,
は付けません。 - 最終確認日
-
2024-09-01
2.使用可能な箇所
フロー
受け入れる要素に
配置できます。
table
フロー
3.配置できるコンテンツ
caption要素,
colgroup要素,
thead要素,
tfoot要素,
tbody要素,
tr要素を
配置できます。
table
script
<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> - </th> <th> total </th> <td> data99 </td> </tr> </tfoot>
</table>
table
フォーマット
コンテキスト
キャプション
ボックス
フォーマット
コンテキスト
トラック
グループ
ボックス
トラック
ボックス
コンテナ
ボックス
ボックスで表すと、table
table
尚、この説明は各要素のレンダリングに関する指定が既定値での話で、個々にスタイルを指定した場合はこの限りではありません。
4.属性
グローバル属性のみ、
設定できます。
table
5.Web API
id属性を用いて
getElementById()メソッドで
要素を取得する方法がお勧めです。
table
6.レンダリング
table {
display: table;
box-sizing: border-box;
border-spacing: 2px;
border-collapse: separate;
text-indent: initial;
unicode-bidi: isolate;
}
table
ブロック
border-collapse
は、表(テーブル)の中のセルが境界を共有するか分離するかを設定します。separate
は、隣接するセルが個別に境界線を持つです。
尚これは、テーブル
HTML Living Standard でのレンダリングの提案の量が 少々多いので、ここでは一部の抜粋としています。
詳細は 15 Rendering 15.3.8 Tablesをご覧ください。
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=""> <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>
table
とりあえず詰め込んだ例示なので、組み合わせによっては効果のない物もあります。またスクリプトにて動的に処理している為、指定する順番で効果が異なる可能性もあります。
実際に使用する場合は、動作確認を改めて行ってから採用して下さい。
7.気を付ける点
幅
フレージング
描画
table