<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.

* Some parts of this feature may have varying levels of support.

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
# the-th-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
th
abbr
align
Deprecated
axis
Deprecated
bgcolor
Deprecated
char
Deprecated
charoff
Deprecated
colspan
headers
rowspan
rowspan attribute with value 0 (extend to the end of the row group)
scope
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.

参见