<th>

HTML <th> 元素定义表格内的表头单元格。这部分特征是由 scope and headers 属性准确定义的。

内容范畴 (en-US)
允许内容
流内容(除 header、footer、sectioning content 或 heading content 的继承。)
遗漏标签 开始标签是必需要的,而结束标签有时可以省略:当其后是<th><td> ,或者其后没有其他数据内容在其父元素内,。
允许的父级元素 <tr> 元素
元素类型 任何
DOM 接口 HTMLTableHeaderCellElement (en-US)

属性

该元素包含 全局属性

abbr 已弃用

这个属性包含一个关于单元格内容的简单的介绍。一个用户代理(例如,语音阅读器)可能出现在描述之前。

备注: 不要使用这个属性,因为它已经在最新标准中过时。相对的,你可以把简短的描述放置于单元格内,把较长的描述内容放到 title 属性内。

align 已弃用

这个枚举属性指定单元格内容的水平对齐方式。可能的值有:

  • left: 单元格内容左对齐
  • center: 单元格内容居中
  • right: 单元格内容右对齐
  • justify (仅文字内容): 内容拉伸以覆盖单元格
  • char (仅文字内容): 内容相对<th>标签中的某个字符对齐(默认值是页面语言的小数点字符)。该字符由charcharoff 属性定义。对齐方式的默认值是 left.

备注: 不要使用这个属性,因为它已经在最新标准中过时。

  • left, center, rightjustify 这些对齐效果,应该使用 CSS 的text-align 来实现。
  • char 的对齐效果使用 CSS 的 text-align 实现, char亦同. 未实现 in CSS3.
axis 已弃用

这个属性包含了一个空间分隔的字符串的列表。每个字符串是一组单元格的 ID,而该表头适用于这个 ID。

备注: 不要使用这个属性,因为它已经在最新标准中过时。应该使用 scope 属性代替。

bgcolor 非标准

这个属性定义了每列中每单元格的背景色。它由带有 ‘#’ 前缀的 6 位数的十六进制码组成,并在sRGB中被定义。这个属性可能会用到十六个预定义的颜色字符串儿之一。

备注: 不要使用这个属性,它不是标准属性且仅在某些版本的 Microsoft Internet Explorer 支持: <th> 元素应当用CSS来样式化。为了创造出同样的效果只需要使用CSS中的background-color属性就可以啦。

char 已弃用

列中的内容与<th> 元素中的字母对齐。通常其值包含一个 (.) 来排列数字或者货币值。 如果 align没有被设置为char,这个属性就会被忽略。

备注: 不要使用这个属性,因为它已经在最新标准中过时。为了达到同样的效果, 你可以指定该字母为text-align 属性中的第一个值,或通过 CSS3 中的未实现

charoff 已弃用

这个属性用来将列数据移到 char 属性指定字母的右边。 其值指定了移动的长度。

备注: 不要使用这个属性,因为它已经在最新标准中过时。

colspan

这个属性包含一个正整数表示了每单元格中扩展列的数量。默认值为1 。超过 1000 的值被视作 1000。

headers

这个属性包含了一个空间分隔的字符串的列表,每个与其他<th>元素相关联的id 属性一一对应。

rowspan

这个属性包含一个正整数表示了每单元格中扩展列的数量。默认值为1. 如果该值被设置为 0, 这个单元格就被扩展为 (<thead><tbody> (en-US)<tfoot>) 中表格部分的最后一个元素。比 65534 大的值被视作 65534。

scope

这个枚举属性定义了表头元素 (在<th>中定义) 关联的单元格。它可能有以下值:

  • row: 表头关联一行中所有的单元格。
  • col: 表头关联一列中所有的单元格。
  • rowgroup:表头属于一个行组并与其中所有单元格相关联。这些单元格可以被放在表头的左侧或右侧,取决于 <table> 元素中 dir 属性的值 。
  • colgroup: 表头属于一个列组并与其中所有单元格相关联。
  • auto
valign 已弃用

这个属性指定了单元格内文本的垂直对齐方式。这个属性可能有以下值:

  • baseline: 将文本置于单元格底部并将其与字母的baseline对齐而不是与底部。若字母没有 baseline 以下的部分(即为无降部)那么 baseline 值起到的效果便和bottom 相同。
  • bottom: 将文本置于底部。
  • middle: 将文本置于单元格中央。
  • top: 将文本置于单元格顶部。

备注: 不要使用这个属性,因为它已经在最新标准中过时。使用 CSS vertical-align特性代替。

width 已弃用

这个属性用来定义一个期望的单元格宽。额外的空间可以藉由cellspacing (en-US)cellpadding (en-US) 属性来增加,并且<col>元素的宽也可以创造额外空间。但是,如果一列宽太窄以至于无法恰当显示 某单元格时,它会被自动加宽。

备注: 不要使用这个属性,因为它已经在最新标准中过时。使用 CSS width属性代替。

示例

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

规范

Specification
HTML Standard
# the-th-element

浏览器兼容性

BCD tables only load in the browser

参阅