<th>

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 <th> 元素定义表格内的表头单元格。这部分特征是由 scopeheaders 属性准确定义的。

尝试一下

属性

该元素包含全局属性

abbr

一个简短的描述,作为对表头单元格内容的替代标签,用于在其他上下文中引用该单元格。一些用户代理(如语音阅读器)可能会在内容本身之前呈现此描述。

colspan

一个非负整数值,指示表头单元格跨越或扩展多少列。默认值为 1。用户代理会将大于 1000 的值视为不正确,而默认将其设置为 1。

headers

包含了一个空格分隔的字符串(对应于为此表头单元格提供标题的 <th> 元素的 id 属性)的列表。

rowspan

一个非负整数值,指示表头单元格跨越或扩展多少行。默认值为 1。如果该值被设置为 0,这个单元格就被扩展到 <th> 所属的表格分组部分(<thead><tbody><tfoot>)的最后一个单元。比 65534 大的值被会被裁剪到 65534

scope

定义了表头元素(在 <th> 中定义)关联的单元格。可能的枚举值如下:

  • row:表头关联所属的行中所有的单元格。
  • col:表头关联所属的列中所有的单元格。
  • rowgroup:表头属于一个行组并与其中所有单元格相关联。
  • colgroup:表头属于一个列组并与其中所有单元格相关联。

如果未指定 scope 属性,或其值不是 rowcolrowgroupcolgroup,则浏览器会自动选择标题单元格适用的单元格集。

已弃用的属性

以下属性已被弃用,不应使用。下面记录它们是为了在更新现有代码时提供参考,并供参考历史。

align 已弃用

指定单元格内容的水平对齐方式。可能的枚举值有:leftcenterrightjustifychar。在受支持的情况下,char 值可以让文本内容根据 char 属性中指定的字符以及 charoff 属性指定的偏移量进行对齐。该属性已弃用,请使用 CSS text-align 属性代替。

axis 已弃用

包含一个空格分隔的字符串列表。每个字符串对应一组该表头适用的单元格的 id 属性。该属性以弃用,请使用 scope 属性代替。

bgcolor 已弃用

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

char 已弃用

无任何行为。它最初用于将内容与表头单元格的指定字符对齐。当尝试对齐数字或货币值时,其值通常包含一个句点(.)。如果 align 属性没有设置为 char,则此属性将被忽略。

charoff 已弃用

无任何行为。它最初用于指定表头单元格内容与 char 属性指定的字符之间的偏移量。

height 已弃用

定义建议的表头单元格高度。该属性已弃用,请使用 CSS height 属性代替。

valign 已弃用

指定表头单元格内文本的垂直对齐方式。可能的枚举值有:baselinebottommiddle 和 d top。该属性已弃用,请使用 CSS vertical-align 属性代替。

width 已弃用

定义建议的表头单元格宽度。该属性已弃用,请使用 CSS width 属性代替。

使用说明

  • 只能在 <tr> 元素内使用 <th>
  • 在简单的上下文中,在表头单元格(<th> 元素)上使用 scope 属性是多余的,因为 scope 会被默认推断。然而,某些辅助技术可能无法正确推断,因此指定标题范围可能会改善用户体验。
  • 当使用 colspanrowspan 属性来使表头单元格跨越多个列和行时,未定义这些属性的单元格(默认为 1)会自动适配表结构中的空闲可用空间,跨越 1x1 单元格,如下图所示:

演示表格单元的列和行跨越的插图:单元格 1、3 和 4 跨越两行;单元格 2 跨越两列;单元格 5 和 6 适配第二行第二列和第三列的可用单元格

备注: 这些属性不能用于重叠单元格。

示例

参考 <table><th> 的示例内容。

技术概要

内容分类 无。
允许的内容 流式内容 content,但不能有页眉(header)、页脚(footer)、分段内容或标题内容作为后代元素。
标签省略 开始标签是必须的。
结束标签有时可以省略:当其后是 <th><td> 元素,或者其后没有其他数据内容在其父元素内。
允许的父元素 <tr> 元素。
隐含的 ARIA 角色 columnheaderrowheader
允许的 ARIA 角色 任意
DOM 接口 HTMLTableCellElement

规范

Specification
HTML Standard
# the-th-element

浏览器兼容性

BCD tables only load in the browser

参见