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

col要素

1.仕様

COL要素は、
表(テーブル)の
列を表します。

col

列 (table column)

種類
空要素

任意のコンテンツを持つことができない要素です。

カテゴリ

なし

使用できるコンテキスト
colgroup要素に 1つ

colgroup要素に 1つを そのコンテンツとして、使用できます。

span属性を持たない colgroup要素の子として。

コンテンツモデル
何もない

要素のコンテンツモデルが「何もない」の場合、要素にはテキストノード (要素間の空白以外) と要素ノードが含まれていてはなりません。

タグの省略

終了タグはありません。

コンテンツ属性
グローバル属性 他
span属性
要素がまたがる列の数
DOM インターフェイス
HTMLTableColElement
  1. [Exposed=Window]
  2. interface HTMLTableColElement : HTMLElement {
  3. [HTMLConstructor] constructor();
  4.  
  5. [CEReactions] attribute unsigned long span;
  6.  
  7. // also has obsolete members
  8. };
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. col {
  2. display: table-column;
  3. unicode-bidi: isolate;
  4. }
  5. col[hidden] {
  6. display: table-column;
  7. visibility: collapse;
  8. }

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

説明
col要素は、列を表します。

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

  1. <!DOCTYPE html>
  2. <html lang="ja">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>col要素の例 - (Example of col element) | 離珠のHTMLでしぃ！</title>
  6. </head>
  7. <body>
  8. <h1>col要素の例</h1>
  9. <table>
  10. <caption>col要素の例</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>

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

参照元
参照元
JSONデータ
JSON形式での、データのイメージです。
  1. {
  2. "col": {
  3. "check": "2024-09-01",
  4. "group": "Table",
  5. "element": "- X EMPTY -- subwindow (Void elements.) [None] --",
  6. "attlist": {
  7. "%Global;": "",
  8. "span": "NUMBER 1 -- default number of columns in group --",
  9. },
  10. "comment": "列 (table column)",
  11. "point": "列を表します。",
  12. "description": "表(テーブル・table)の列を表します。",
  13. "kind": "Void",
  14. "categories": "None",
  15. "used": "colgroup col",
  16. "usedsupplement": "span属性を持たない colgroup要素の子として。",
  17. "contentmodel": "%Nothing",
  18. "tag": [
  19. "-",
  20. "X",
  21. ],
  22. "attributes": {"span": "要素がまたがる列の数"},
  23. "dominterface": "HTMLTableColElement",
  24. "rendering": [
  25. "Tables",
  26. "Bidirectional",
  27. ],
  28. "reference": [
  29. {
  30. "title": "HTML Living Standard. 4.9.4 The col element.",
  31. "href": "https://html.spec.whatwg.org/multipage/tables.html#the-col-element",
  32. "heading": "HTML Living Standard. 4.9.4 The col element",
  33. "sub": "Last Updated 27 August 2024",
  34. },
  35. {
  36. "title": "HTML Living Standard. 15 Rendering 15.3.8 Tables.",
  37. "href": "https://html.spec.whatwg.org/multipage/rendering.html#tables-2",
  38. "heading": "HTML Living Standard. 15 Rendering 15.3.8 Tables",
  39. "sub": "Last Updated 27 August 2024",
  40. },
  41. {
  42. "title": "HTML 5.2 W3C Recommendation. 4.9.4 The col element. W3C Recommendation, 14 December 2017.",
  43. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/tabular-data.html#the-col-element",
  44. "heading": "HTML 5.2 W3C 勧告. 4.9.4 The col element",
  45. "sub": "W3C勧告、2017年12月14日",
  46. },
  47. {
  48. "title": "HTML 5.2 W3C Recommendation. 10.3.9. Tables.",
  49. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/rendering.html#tables",
  50. "heading": "HTML 5.2 W3C 勧告. 10.3.9. Tables",
  51. "sub": "W3C勧告、2017年12月14日",
  52. },
  53. {
  54. "title": "HTML 5.1 W3C Recommendation. 4.9.4 The col element. W3C Recommendation, 1 November 2016.",
  55. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/tabular-data.html#the-col-element",
  56. "heading": "HTML 5.1 W3C 勧告. 4.9.4 The col element",
  57. "sub": "W3C勧告、2016年11月1日",
  58. },
  59. {
  60. "title": "HTML 5.1 W3C Recommendation. 10.3.9. Tables. W3C Recommendation, 1 November 2016.",
  61. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/rendering.html#tables",
  62. "heading": "HTML 5.1 W3C 勧告. 10.3.9. Tables",
  63. "sub": "W3C勧告、2016年11月1日",
  64. },
  65. {
  66. "title": "HTML 5 W3C Recommendation. 4.9.4 The col element. W3C Recommendation, 28 October 2014.",
  67. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/tabular-data.html#the-col-element",
  68. "heading": "HTML 5 W3C 勧告. 4.9.4 The col element",
  69. "sub": "W3C勧告、2014年10月28日",
  70. },
  71. {
  72. "title": "HTML 5 W3C Recommendation. 10.3.9 Tables. W3C Recommendation, 28 October 2014.",
  73. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/rendering.html#tables",
  74. "heading": "HTML 5 W3C 勧告. 10.3.9 Tables",
  75. "sub": "W3C勧告、2014年10月28日",
  76. },
  77. {
  78. "title": "HTML 4.01 Specification W3C Recommendation. 11.2.4 Column groups: the COLGROUP and COL elements. W3C Recommendation 24 December 1999.",
  79. "href": "https://www.w3.org/TR/html401/struct/tables.html#h-11.2.4",
  80. "heading": "HTML 4.01 Specification W3C 勧告. 11.2.4 Column groups: the COLGROUP and COL elements",
  81. "sub": "W3C勧告1999年12月24日",
  82. },
  83. {
  84. "title": "HTML 3.2 Reference Specification. W3C Recommendation 14-Jan-1997.",
  85. "href": "https://www.w3.org/TR/2018/SPSD-html32-20180315/",
  86. "heading": "HTML 3.2 Reference Specification",
  87. "sub": "W3C勧告1997年1月14日",
  88. },
  89. {
  90. "title": "MDN Web Docs. HTML <col>: The Table Column element.",
  91. "href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/col",
  92. "heading": "<col>: 表の列要素 - HTML: ハイパーテキストマークアップ言語 | MDN",
  93. },
  94. ],
  95. "version": {
  96. "first": "HTML4",
  97. "latest": "HTML Living Standard",
  98. },
  99. }
  100. }

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

最終確認日

2024-09-01

2.使用可能な箇所

colgroup要素 に
配置できます。

col要素を使用できる状態(コンテキスト・Context)は、 span属性を持たない colgroup要素に配置できます。

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

配置可能なコンテンツは
ありません。

col要素は、任意の内容(コンテンツ・Content)を持つことができない空要素です。

4.属性

グローバル属性と、
span属性 を
設定できます。

col要素は、グローバル属性と span属性 を設定できます。

span属性

  1. <table>
  2. <colgroup>
  3. <col>
  4. <col span="" style="background-color: #ccffff;">
  5. </colgroup>
  6. <thead>
  7. <tr><th>id</th><th>name</th><th>data</th></tr>
  8. </thead>
  9. <tbody>
  10. <tr><td>10</td><th>name01</th><td>data01</td></tr>
  11. <tr><td>20</td><th>name02</th><td>data02</td></tr>
  12. </tbody>
  13. <tbody>
  14. <tr><td>55</td><th>name55</th><td>data55</td></tr>
  15. <tr><td>57</td><th>name57</th><td>data57</td></tr>
  16. <tr><td>59</td><th>name59</th><td>data59</td></tr>
  17. </tbody>
  18. <tfoot>
  19. <tr><td>-</th><th>total</th><td>data99</td></tr>
  20. </tfoot>
  21. </table>

span属性は、要素がまたがる列の数を指定します。

idnamedata
10name01data01
20name02data02
55name55data55
57name57data57
59name59data59
-totaldata99

5.Web API

id属性を用いて
getElementById()メソッドで
要素を取得する方法がお勧めです。

col要素を表すプロパティはないので、id属性を用いて documentの getElementById()メソッドで、要素を取得する方法がお勧めです。この時に取得できるのはHTMLTableColElement オブジェクトです。

6.レンダリング

  1. col {
  2. display: table-column;
  3. unicode-bidi: isolate;
  4. }

col要素は、ブロックレベルのテーブルフォーマットコンテキストに参加する適切な内部テーブルボックスを生成します。

caption
10name01data01
20name02data02
  1. <table style="border-collapse: ;
    border-spacing: px; border: ;">
  2. <caption style="caption-side: ;
    border-style: ;
    border-width: px;">caption</caption>
  3. <colgroup>
  4. <col>
  5. <col span="" style="background-color: #ccffff; border: ;">
  6. </colgroup>
  7. <tbody>
  8. <tr><td>10</td><th>name01</th><td>data01</td></tr>
  9. <tr><td>20</td><th>name02</th><td>data02</td></tr>
  10. </tbody>
  11. </table>

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

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

table要素のborder-collapseプロパティとcolgroup要素のborderプロパティとは関係がある様で、組み合わせによってはcolgroup要素のborderプロパティが無効の事があります。

7.気を付ける点

列

列(Column.) は、セル(Cell.) の積み上げで表しているので、安易に colgroup要素, col要素を用いない方が良いかもしれません。

テンプレートエンジンなどを用いれば、セル自体を細工して列の処理が出来ますし、 動的にスクリプトで処理するなら、セルを起点として列単位にセルに対して処理すれば良い訳です。

8.付記