<table>:表格元素

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.

HTML <table> 元素表示表格数据——即在一个由包含数据的行和列组成的二维表格中呈现的信息。

尝试一下

内容分类 流式内容
允许的内容 按照这个顺序:
  1. 一个可选的 <caption> 元素
  2. 零个或多个的 <colgroup> 元素
  3. 一个可选的 <thead> 元素
  4. 下列任意一个:
  5. 一个可选的 <tfoot> 元素
标签省略 不允许,开始标签和结束标签都不能省略。
允许的父元素 任何支持流式内容的元素
隐含的 ARIA 角色 table
允许的 ARIA 角色 任意
DOM 接口 HTMLTableElement

属性

此元素包含所有的全局属性

弃用的属性

align 已弃用

这个枚举属性指定了包含在文档中的表格必须如何对齐。可能含有如下值:

  • left:表格将在文档左侧显示;
  • center:表格将在文档中央显示;
  • right:表格将在文档右侧显示;

设置 margin-leftmargin-rightauto,或者将 margin 设置为 0 auto 来实现类似于 align 属性的效果。

bgcolor 已弃用

表格的背景颜色。它是一个 6 位的十六进制 RGB 编码,以 '#' 作为前缀。当然也可以使用下面已经被预先定义的颜色关键字

为了实现相似的效果,可以使用 CSS 属性 background-color

border 已弃用

这个整型属性定义了环绕表格外部的框的大小。如果设置为 0,这意味着 frame 属性被设置为空。

为了实现相似的效果,可以使用 CSS 简写属性 border

cellpadding 已弃用

这个属性定义了一个单元格的内容和它的边框之间的空间,无论显示与否。如果 cellpadding 的长度是用像素定义的,这个像素大小的空间将被应用到单元格内容的所有四边。如果长度是用百分比值定义的,内容将被居中,总的垂直空间(顶部和底部)将代表这个值。对于总的水平空间(左边和右边)也是如此。

为了实现相似的效果,可以在 <table> 元素上使用属性值为 collapse 的 border-collapse 属性,在 <td> 元素上使用属性 padding

cellspacing 已弃用

这个属性定义了水平和垂直方向上两个单元格之间空间的大小,使用百分比或像素,包括了表格的顶部与第一行的单元格、表的左边与第一列单元格、表的右边与最后一列的单元格、表的底部与最后一行单元格之间的空间。

为了实现相似的效果,可以在 <table> 元素上使用 CSS 属性 border-spacingborder-spacingborder-collapse 设置为 collapse 时将无效。

frame 已弃用

这个枚举属性定义了包围在表格周围的框架的哪个边必须显示。

为了实现相似的效果,可以使用 CSS 属性 border-styleborder-width

rules 已弃用

这个枚举属性定义了在一个表格中分隔线的显示位置。它可以有以下值:

  • none,这表明没有分隔线将被显示;这是默认的值;
  • groups,这将使得分隔线只显示在行组(row group,通过 <thead><tbody><tfoot> 元素定义)和列组(column group,通过 <col><colgroup> 元素定义)之间
  • rows,这将使得分隔线在行之间显示;
  • cols,这将使得分隔线在列之间显示;
  • all,这将使得分隔线在列和行之间显示;

为了实现相似的效果,可以在适当的 <thead><tbody><tfoot><col><colgroup> 元素上使用 border 属性。

summary 已弃用

该属性定义了概括表格内容的替代文本。请使用 <caption> 元素代替。

width 已弃用

该属性定义了表格的宽度。请使用 CSS width 属性代替。

示例

简单的表格

html
<table>
  <tr>
    <td>John</td>
    <td>Doe</td>
  </tr>
  <tr>
    <td>Jane</td>
    <td>Doe</td>
  </tr>
</table>

更多简单示例

html
<p>含有表头的表格</p>
<table>
  <tr>
    <th></th>
    <th></th>
  </tr>
  <tr>
    <td>John</td>
    <td>Doe</td>
  </tr>
  <tr>
    <td>Jane</td>
    <td>Doe</td>
  </tr>
</table>

<p>含有表头、表尾和表格主体的表格</p>
<table>
  <thead>
    <tr>
      <th>表头内容 1</th>
      <th>表头内容 2</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>表格主体内容 1</td>
      <td>表格主体内容 2</td>
    </tr>
  </tbody>
  <tfoot>
    <tr>
      <td>表尾内容 1</td>
      <td>表尾内容 2</td>
    </tr>
  </tfoot>
</table>

<p>有列组的表格</p>
<table>
  <colgroup span="4"></colgroup>
  <tr>
    <th>国家</th>
    <th>首都</th>
    <th>人口数量</th>
    <th>语言</th>
  </tr>
  <tr>
    <td>美国</td>
    <td>华盛顿</td>
    <td>3.09 亿</td>
    <td>英语</td>
  </tr>
  <tr>
    <td>瑞典</td>
    <td>斯德哥尔摩</td>
    <td>900 万</td>
    <td>瑞典语</td>
  </tr>
</table>

<p>有列组和列的表格</p>
<table>
  <colgroup>
    <col style="background-color: #0f0" />
    <col span="2" />
  </colgroup>
  <tr>
    <th>青柠</th>
    <th>柠檬</th>
    <th>橘子</th>
  </tr>
  <tr>
    <td>绿色</td>
    <td>黄色</td>
    <td>橙色</td>
  </tr>
</table>

<p>有标题的简单表格</p>
<table>
  <caption>
    美妙的标题
  </caption>
  <tr>
    <td>美妙的数据</td>
  </tr>
</table>

表格排序

对表格的行进行排序

没有原生的方法对 HTML 表格的行(<tr>元素)进行排序。但是通过使用 Array.prototype.slice()Array.prototype.sort()Node. removeChild()Node.appendChild(),你可以实现你自己的 sort() 函数来对 <tr> 元素的HTMLCollection 进行排序。

在下面的示例中,你可以看到具体如何这样做。我们把这个自定义方法附加到 <tbody> 元素上,这样它就会按照数值增加的顺序对表格单元格进行排序,并更新显示内容以适应需要。

HTML
html
<table>
  <tbody>
    <tr>
      <td>3</td>
    </tr>
    <tr>
      <td>2</td>
    </tr>
    <tr>
      <td>1</td>
    </tr>
  </tbody>
</table>
JavaScript
js
HTMLTableSectionElement.prototype.sort = function (cb) {
  Array.from(this.rows)
    .sort(cb)
    .forEach((e) => this.appendChild(this.removeChild(e)));
};
document
  .querySelector("table")
  .tBodies[0].sort((a, b) => a.textContent.localeCompare(b.textContent));
结果

通过点击 th 元素对行进行排序

下面的示例给 document 中每个 <table> 的每个 <th> 元素添加了一个事件处理程序;它对所有 <tbody> 的行进行排序,排序的基础是行中包含的 td 单元格。

备注: 这个解决方案假设 <td> 元素是由原始文本填充的,没有子元素。

HTML
html
<table>
  <thead>
    <tr>
      <th>数字</th>
      <th>字母</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>3</td>
      <td>A</td>
    </tr>
    <tr>
      <td>2</td>
      <td>B</td>
    </tr>
    <tr>
      <td>1</td>
      <td>C</td>
    </tr>
  </tbody>
</table>
JavaScript
js
const allTables = document.querySelectorAll("table");
for (const table of allTables) {
  const tBody = table.tBodies[0];
  const rows = Array.from(tBody.rows);
  const headerCells = table.tHead.rows[0].cells;
  for (const th of headerCells) {
    const cellIndex = th.cellIndex;
    th.addEventListener("click", () => {
      rows.sort((tr1, tr2) => {
        const tr1Text = tr1.cells[cellIndex].textContent;
        const tr2Text = tr2.cells[cellIndex].textContent;
        return tr1Text.localeCompare(tr2Text);
      });
      tBody.append(...rows);
    });
  }
}
结果

在小空间展示大型表格

网络上表格的一个普遍问题是,当内容量很大时,它们在小屏幕上的原生效果并不好,而且使它们可滚动的方法并不明显,特别是当标记可能来自 CMS,无法添加一个包装器时。

这个例子提供了一种在小空间中显示表格的方法。我们隐藏了 HTML 内容,因为它非常大,而且没有什么特别之处。在这个例子中,研究其 CSS 代码更有用。

当查看这些样式时,你会注意到表格的 display 属性已被设置为 block。虽然允许滚动,但表格失去了一些完整性,而且表格单元格会尽量变小。为了缓解这个问题,我们在 <tbody> 上将 white-space 设置为 nowrap。然而,我们没有对 <thead> 进行设置,以避免长标题迫使列的宽度超过显示数据所需的宽度。

为了在向下滚动时保持表头在页面上,我们在 <th> 元素上将 position 设置为 sticky。注意,我们没有border-collapse 设置为 collapse,因为如果我们这样做,表头就不能与表格的其他部分正确分开。

css
table,
th,
td {
  border: 1px solid;
}

table {
  width: 100%;
  max-width: 400px;
  height: 240px;
  margin: 0 auto;
  display: block;
  overflow-x: auto;
  border-spacing: 0;
}

tbody {
  white-space: nowrap;
}

th,
td {
  padding: 5px 10px;
  border-top-width: 0;
  border-left-width: 0;
}

th {
  position: sticky;
  top: 0;
  background: #fff;
  vertical-align: bottom;
}

th:last-child,
td:last-child {
  border-right-width: 0;
}

tr:last-child td {
  border-bottom-width: 0;
}

结果

无障碍考虑

标题

提供一个清晰简洁地描述了表格的目的 <caption> 元素,有助于人们决定是否需要阅读表格的其他内容或跳过它。

这有助于借助辅助技术(如屏幕阅读器)进行导航的人、经历低视力状况的人和有认知问题的人。

确定行和列的范围

头部元素的 scope 属性在简单情况下是多余的,因为范围是推断出来的。然而,一些辅助技术可能无法做出正确的推断,所以指定头的范围可能会改善用户体验。在复杂的表格中,可以指定范围以提供与标题相关的单元格的必要信息。

示例

html
<table>
  <caption>
    表格名称和值
  </caption>
  <tbody>
    <tr>
      <th scope="col">名称</th>
      <th scope="col">HEX</th>
      <th scope="col">HSLa</th>
      <th scope="col">RGBa</th>
    </tr>
    <tr>
      <th scope="row">Teal</th>
      <td><code>#51F6F6</code></td>
      <td><code>hsla(180, 90%, 64%, 1)</code></td>
      <td><code>rgba(81, 246, 246, 1)</code></td>
    </tr>
    <tr>
      <th scope="row">Goldenrod</th>
      <td><code>#F6BC57</code></td>
      <td><code>hsla(38, 90%, 65%, 1)</code></td>
      <td><code>rgba(246, 188, 87, 1)</code></td>
    </tr>
  </tbody>
</table>

<th> 元素上提供声明 scope="col",将有助于描述该单元格处于一列的顶部。在 <th> 元素上提供声明 scope="row",将有助于描述该单元格是某一行的第一个。

复杂表格

诸如屏幕阅读器等辅助技术可能难以解析那些复杂到标题单元不能以严格的水平或垂直方式关联的表格。这通常由 colspanrowspan 属性的存在表示。

理想情况下,考虑用其他方式来展示表格的内容,包括将其分解成一系列较小的、相关的表格,而不必依赖 colspanrowspan 属性。除了帮助使用辅助技术的人理解表的内容外,这也可能有利于有认知障碍的人,这些人可能难以理解表的布局所描述的关联。

如果表格不能被拆开,使用 idheaders 属性的组合,以编程方式将每个表格单元与该单元所关联的标题相关联。

规范

Specification
HTML
# the-table-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
table
align
Deprecated
bgcolor
Deprecated
border
Deprecated
cellpadding
Deprecated
cellspacing
Deprecated
frame
Deprecated
rules
Deprecated
summary
Deprecated
width
Deprecated

Legend

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

Full support
Full support
Deprecated. Not for use in new websites.

参见