colgroup要素

1.仕様

colgroup

列のグループ (table column group)

種類

通常要素

カテゴリ

なし

使用できるコンテキスト

<table>要素の子である<caption>要素の後

<table>要素の子である<caption>要素の後のコンテンツとして、使用できます。

table要素の子として、caption要素の後、thead, tbody, tfoot および tr要素の前にあります。

コンテンツモデル

<col>要素または<template>要素のいずれかを0個以上

<col>要素または<template>要素のいずれかを0個以上が配置できます。

span属性が存在する場合は、なし。spam属性が存在しない場合は、0 個以上のcol要素と template要素。

タグの省略

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

colgroup要素内の最初の要素が col要素であり、その要素の直前に終了タグが省略された別の colgroup 要素が存在しない場合は、colgroup要素の開始タグを省略できます。 (要素が空の場合は省略できません。)

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

コンテンツ属性

グローバル属性 他

span属性

要素がまたがる列の数

DOM インターフェイス

HTMLTableColElement

1. [Exposed=Window]
2. interface HTMLTableColElement : HTMLElement {
3. lastReviewed;
4. [HTMLConstructor] constructor();
5.  
6. [CEReactions] attribute unsigned long span;
7.  
8. // also has obsolete members
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

暗黙的="No" ARIAロール="No" aria-* 属性="No"

暗黙的な ARIAセマンティクスがありませんが、意味はあり、この意味は、ARIA によって提供されず、ARIA のユーザーに公開されていないロール、状態、プロパティで表現される可能性があります。

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

記述できる aria-* 属性はありません。

レンダリング

ブロックボックス

テーブル

1. colgroup {
2. display: table-column-group;
3. unicode-bidi: isolate;
4. }
5. colgroup[hidden] {
6. display: table-column-group;
7. visibility: collapse;
8. }
9. table[rules=groups i] > colgroup {
10. border-inline-width: 1px;
11. border-inline-style: solid;
12. }

CSS を大雑把に読むと、 表組版コンテキストに参加する適切な内部テーブルボックス(テーブルトラックグループボックス)を生成する。ただ、このボックスはレンダリングされません。 などになります。

説明

colgroup要素は、列のグループを表します。

colgroup要素は、表(テーブル・table)の列のグループを表します。

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

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

参照元

参照元

• HTML Living Standard. 4.9.3 The colgroup element (最終更新日 2025年8月29日)
• HTML Living Standard. 15 Rendering 15.3.8 Tables (最終更新日 2025年8月29日)
• HTML 5.3 W3C 初公開ワーキングドラフト. 4.9.3 The colgroup element (W3Cワーキングドラフト、2017年12月14日)
• HTML 5.3 W3C 初公開ワーキングドラフト. 10. Rendering 10.3.9. Tables (W3Cワーキングドラフト、2017年12月14日)
• HTML 5.2 W3C 勧告. 4.9.3 The colgroup element (W3C勧告、2017年12月14日)
• HTML 5.2 W3C 勧告. 10.3.9. Tables (W3C勧告、2017年12月14日)
• HTML 5.1 W3C 勧告. 4.9.3 The colgroup element (W3C勧告、2016年11月1日)
• HTML 5.1 W3C 勧告. 10.3.9. Tables (W3C勧告、2016年11月1日)
• HTML 5 W3C 勧告. 4.9.3 The colgroup element (W3C勧告、2014年10月28日)
• HTML 5 W3C 勧告. 10.3.9 Tables (W3C勧告、2014年10月28日)
• HTML 4.01 Specification W3C 勧告. 11.2.4 Column groups: the COLGROUP and COL elements (W3C勧告1999年12月24日)
• HTML 3.2 Reference Specification (W3C勧告1997年1月14日)
• <colgroup>: 表の列グループ要素 - HTML: ハイパーテキストマークアップ言語 | MDN

JSONデータ

JSON形式での、データのイメージです。

1. {
2. "colgroup": {
3. "group": "Tables",
4. "element": "O O (col|template)* -- table column group. (Normal elements.) [None] --",
5. "attlist": {
6. "%Global;": "",
7. "span": "NUMBER 1 -- default number of columns in group --",
8. },
9. "summary": "列のグループ (table column group)",
10. "point": "列のグループを表します。",
11. "description": "表(テーブル・table)の列のグループを表します。",
12. "elementKind": "Normal",
13. "categories": "None",
14. "canUsedContexts": "table (caption?,colgroup*,thead?,(tbody|tr)*,tfoot?)",
15. "usedsupplement": "table要素の子として、caption要素の後、thead, tbody, tfoot および tr要素の前にあります。",
16. "contentModel": "colgroup (col|template)*",
17. "contentmodelsupplement": "span属性が存在する場合は、なし。spam属性が存在しない場合は、0 個以上のcol要素と template要素。",
18. "tagOmission": [
19. "O",
20. "O",
21. ],
22. "tagsupplement": [
23. "colgroup要素内の最初の要素が col要素であり、その要素の直前に終了タグが省略された別の colgroup 要素が存在しない場合は、colgroup要素の開始タグを省略できます。 (要素が空の場合は省略できません。)",
24. "colgroup要素の直後に ASCII 空白またはコメントが続かない場合は、colgroup要素の終了タグを省略できます。",
25. ],
26. "rendering": [
27. "Tables",
28. "Bidirectional",
29. ],
30. "domInterface": "HTMLTableColElement",
31. "contentAttributes": {"span": "要素がまたがる列の数"},
32. "reference": [
33. {
34. "title": "HTML Living Standard. 4.9.3 The colgroup element. Last Updated 29 August 2025",
35. "href": "https://html.spec.whatwg.org/multipage/tables.html#the-colgroup-element",
36. "heading": "HTML Living Standard. 4.9.3 The colgroup element",
37. "sub": "最終更新日 2025年8月29日",
38. },
39. {
40. "title": "HTML Living Standard. 15 Rendering 15.3.8 Tables. Last Updated 29 August 2025",
41. "href": "https://html.spec.whatwg.org/multipage/rendering.html#tables-2",
42. "heading": "HTML Living Standard. 15 Rendering 15.3.8 Tables",
43. "sub": "最終更新日 2025年8月29日",
44. },
45. {
46. "title": "HTML 5.3 W3C Working Draft. 4.9.3 The colgroup element. W3C First Public Working Draft, 14 December 2017",
47. "href": "https://www.w3.org/TR/2017/WD-html53-20171214/tabular-data.html#the-colgroup-element",
48. "heading": "HTML 5.3 W3C 初公開ワーキングドラフト. 4.9.3 The colgroup element",
49. "sub": "W3Cワーキングドラフト、2017年12月14日",
50. },
51. {
52. "title": "HTML 5.3 W3C Working Draft. 10.3.9. Tables. W3C First Public Working Draft, 14 December 2017",
53. "href": "https://www.w3.org/TR/2017/WD-html53-20171214/rendering.html#tables",
54. "heading": "HTML 5.3 W3C 初公開ワーキングドラフト. 10. Rendering 10.3.9. Tables",
55. "sub": "W3Cワーキングドラフト、2017年12月14日",
56. },
57. {
58. "title": "HTML 5.2 W3C Recommendation. 4.9.3 The colgroup element. W3C Recommendation, 14 December 2017.",
59. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/tabular-data.html#the-colgroup-element",
60. "heading": "HTML 5.2 W3C 勧告. 4.9.3 The colgroup element",
61. "sub": "W3C勧告、2017年12月14日",
62. },
63. {
64. "title": "HTML 5.2 W3C Recommendation. 10.3.9. Tables.",
65. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/rendering.html#tables",
66. "heading": "HTML 5.2 W3C 勧告. 10.3.9. Tables",
67. "sub": "W3C勧告、2017年12月14日",
68. },
69. {
70. "title": "HTML 5.1 W3C Recommendation. 4.9.3 The colgroup element. W3C Recommendation, 1 November 2016.",
71. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/tabular-data.html#the-colgroup-element",
72. "heading": "HTML 5.1 W3C 勧告. 4.9.3 The colgroup element",
73. "sub": "W3C勧告、2016年11月1日",
74. },
75. {
76. "title": "HTML 5.1 W3C Recommendation. 10.3.9. Tables. W3C Recommendation, 1 November 2016.",
77. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/rendering.html#tables",
78. "heading": "HTML 5.1 W3C 勧告. 10.3.9. Tables",
79. "sub": "W3C勧告、2016年11月1日",
80. },
81. {
82. "title": "HTML 5 W3C Recommendation. 4.9.3 The colgroup element. W3C Recommendation, 28 October 2014.",
83. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/tabular-data.html#the-colgroup-element",
84. "heading": "HTML 5 W3C 勧告. 4.9.3 The colgroup element",
85. "sub": "W3C勧告、2014年10月28日",
86. },
87. {
88. "title": "HTML 5 W3C Recommendation. 10.3.9 Tables. W3C Recommendation, 28 October 2014.",
89. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/rendering.html#tables",
90. "heading": "HTML 5 W3C 勧告. 10.3.9 Tables",
91. "sub": "W3C勧告、2014年10月28日",
92. },
93. {
94. "title": "HTML 4.01 Specification W3C Recommendation. 11.2.4 Column groups: the COLGROUP and COL elements. W3C Recommendation 24 December 1999.",
95. "href": "https://www.w3.org/TR/html401/struct/tables.html#h-11.2.4",
96. "heading": "HTML 4.01 Specification W3C 勧告. 11.2.4 Column groups: the COLGROUP and COL elements",
97. "sub": "W3C勧告1999年12月24日",
98. },
99. {
100. "title": "HTML 3.2 Reference Specification. W3C Recommendation 14-Jan-1997.",
101. "href": "https://www.w3.org/TR/2018/SPSD-html32-20180315/",
102. "heading": "HTML 3.2 Reference Specification",
103. "sub": "W3C勧告1997年1月14日",
104. },
105. {
106. "title": "MDN Web Docs. HTML <colgroup>: The Table Column Group element.",
107. "href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/colgroup",
108. "heading": "<colgroup>: 表の列グループ要素 - HTML: ハイパーテキストマークアップ言語 | MDN",
109. },
110. ],
111. "version": {
112. "first": "HTML4",
113. "latest": "HTML Living Standard",
114. },
115. "lastReviewed": "2025-08-31",
116. "domsupplement": {"span": "unsigned long"},
117. "obsoleteAttributes": [
118. ],
119. }
120. }

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

最終確認日

2025-08-31

2.使用できるコンテキスト

3.コンテンツモデル

4.コンテンツ属性

5.DOM インターフェイス

6.アクセシビリティ

7.レンダリング

8.気を付ける点