<colgroup>:表格列组元素

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

<colgroup> HTML 元素定义了表格中的一组列。

尝试一下

属性

此元素包含全局属性

span

指定 <col> 元素跨列的连续列数。该值必须是大于 0 的正整数。如果不存在,其默认值为 1

备注: 如果 <colgroup> 中存在一个或多个 <col> 元素,则不允许使用 span 属性。

弃用的属性

以下属性已被弃用,不应再使用。下文记录了这些属性,供更新现有代码时参考,也仅供参考。

align 已弃用

指定每个列组单元格的水平对齐方式。可能的枚举值有 leftcenterrightjustifychar。如果支持,char 值将根据 char 属性中定义的字符和 charoff 属性定义的偏移量对文本内容进行对齐。请注意,后代 <col> 元素可以使用自己的 align 属性覆盖该值。使用 text-align<th> 元素上的 CSS 属性,因为该属性已被弃用。

备注:<colgroup> 元素上设置 text-align 没有任何作用,因为 <td><th> 元素不是 <colgroup> 元素的后代,因此它们不能从该元素继承。

如果表格没有使用 colspan 属性,则在每列使用 td:nth-of-type(an+b) CSS 选择器,其中 a 为表格中列的总数,b 为列在表格中的序号位置,例如 td:nth-of-type(7n+2) { text-align: right; } 可右对齐第二列单元格。

如果表格使用了 colspan 属性,则可以通过组合适当的 CSS 属性选择器(如 [colspan=n])来达到效果,不过这并非易事。

bgcolor 已弃用

定义每列单元格的背景颜色。该值是 HTML 颜色;可以是以“#”为前缀的 6 位十六进制 RGB 代码,也可以是颜色关键字。不支持其他 CSS <color> 值。请使用 background-color CSS 属性代替,因为该属性已被弃用。

char 已弃用

没有任何作用。其最初目的是指定内容与每列单元格中的一个字符对齐。当试图对齐数字或货币值时,其典型值包括句号(.)。如果 align 未设置为 char,该属性将被忽略,但它仍将作为默认值用于属于该列组的 <col> 元素的 align

charoff 已弃用

没有任何作用。它最初用于指定列单元格内容从 char 属性指定的对齐字符偏移的字符数。

valign 已弃用

指定每个列组单元格的垂直对齐方式。可能的枚举值有 baselinebottommiddletop。请注意,后代 <col> 元素可以使用自己的 valign 属性覆盖此值。使用 vertical-align<th> 元素上的 CSS 属性,因为该属性已被弃用。

备注:<colgroup> 元素上设置 vertical-align 没有任何作用,因为 <td><th> 元素不是 <colgroup> 元素的后代,因此它们不能从该元素继承。

如果表格没有使用 colspan 属性,请在每列使用 td:nth-of-type() CSS 选择器,例如,td:nth-of-type(2) { vertical-align: middle; } 使第二列单元格垂直居中。

如果表格使用了 colspan 属性,则可以通过组合适当的 CSS 属性选择器(如 [colspan=n])来达到效果,不过这并非易事。

width 已弃用

该属性为当前列组中的每一列指定默认宽度。除标准像素值和百分比值外,该属性还可以使用特殊形式 0*,这意味着组中每一列的宽度应为容纳该列内容所需的最小宽度。也可以使用相对宽度,如 0.5*。请注意,后代 <col> 元素可以使用自己的 width 属性覆盖此值。请使用 width CSS 属性代替,因为该属性已被弃用。

使用说明

  • <colgroup> 应出现在 <table> 内,任何 <caption> 元素(如果使用)之后,但在任何 <thead><tbody><tfoot><tr> 元素之前。
  • 只有数量有限的 CSS 属性会影响 <colgroup>
    • background:各种 background 属性将为列组中的单元格设置背景。由于列组的背景色绘制在表格顶部,而背景色绘制在列(<col>)和行组(<thead><tbody><tfoot>)上。只有在表格列组上绘制的每个图层都具有透明背景时,应用于表格列组的背景才会可见。
    • border:适用各种 border 属性,但前提是 <table> 已设置 border-collapse: collapse
    • visibility:如果为列组设置 collapse 值,则该列组中列的所有单元格都不会被渲染,而跨入其他列的单元格则会被剪切。列组中的这些列原本占据的空间会被移除。但是,其他列的大小仍然按照列组中被折叠列的单元格计算。visibility 的其他值没有影响。
    • widthwidth 属性定义了列组中的列的最小宽度,如同设置了 min-width

示例

请参阅 <table> 获取介绍通用标准和最佳实践的完整表格示例。

本示例演示了一个七列表格,分为两个跨多列的 <colgroup> 元素。

HTML

两个 <colgroup> 元素用于通过创建列组来构建基本表格。每个列组中的列数由 span 属性指定。

html
<table>
  <caption>
    个人每周活动
  </caption>
  <colgroup span="5" class="weekdays"></colgroup>
  <colgroup span="2" class="weekend"></colgroup>
  <tr>
    <th>周一</th>
    <th>周二</th>
    <th>周三</th>
    <th>周四</th>
    <th>周五</th>
    <th>周六</th>
    <th>周日</th>
  </tr>
  <tr>
    <td>打扫房间</td>
    <td>足球训练</td>
    <td>舞蹈课</td>
    <td>历史课</td>
    <td>买饮料</td>
    <td>自习</td>
    <td>自由时间</td>
  </tr>
  <tr>
    <td>瑜伽</td>
    <td>棋类俱乐部</td>
    <td>见朋友</td>
    <td>体操</td>
    <td>生日派对</td>
    <td>钓鱼之旅</td>
    <td>自由时间</td>
  </tr>
</table>

CSS

分组列可用于使用 CSS 直观地突出显示结构:

css
table {
  border-collapse: collapse;
  border: 2px solid rgb(140 140 140);
}

caption {
  caption-side: bottom;
  padding: 10px;
}

th,
td {
  border: 1px solid rgb(160 160 160);
  padding: 8px 6px;
  text-align: center;
}

.weekdays {
  background-color: #d7d9f2;
}

.weekend {
  background-color: #ffe8d4;
}

结果

技术概要

内容分类 无。
允许的内容 如果存在 span 元素:无。
如果不存在属性:零个或多个 <col> 元素。
标签省略 如果 <col> 元素的第一个子元素是 <col>,并且其前面没有省略结束标签的 <colgroup>,则可以省略开始标签。
如果结束标签后面没有空格或注释,则可以省略结束标签。
允许的父元素 <table> 元素。<colgroup> 必须出现在任何 <caption> 元素之后,而在任何 <thead><tbody><tfoot><tr> 元素之前。
隐式 ARIA 角色 没有对应的角色
允许的 ARIA 角色 没有允许的 role
DOM 接口 HTMLTableColElement

规范

Specification
HTML
# the-colgroup-element

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
colgroup
align
Deprecated
char
Deprecated
charoff
Deprecated
span
valign
Deprecated
width
Deprecated

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Deprecated. Not for use in new websites.
See implementation notes.

参见