HTMLTableCellElement

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.

HTMLTableCellElement 接口提供用于操作 HTML 文档中表格单元格、表头单元格(<th>)或者数据单元格(<td>)的布局和呈现的特定属性和方法(除了常规 HTMLElement 接口之外,它还可以通过继承来使用)。

EventTarget Node Element HTMLElement HTMLTableCellElement

实例属性

从其父接口 HTMLElement 继承属性。

HTMLTableCellElement.abbr

一个可以使用在 <th> 元素(不可用于 <td>)的字符串,它为表头单元格指定备选的标签。此标签可以在其他上下文中使用,例如在描述适用于数据单元格的表头时。它特别用于为屏幕阅读器提供一个更短的术语;并且是一个有价值的无障碍工具。通常,abbr 的值是一个缩写或首字母缩略词,但也可以是任何在上下文中合适的文本。

HTMLTableCellElement.cellIndex 只读

一个表示单元格在其所属的 <tr> 元素的 cells 集合中的位置。如果单元格不属于任何 <tr>,则返回 -1

HTMLTableCellElement.colSpan

一个指示此单元格必须跨越列数的正数;这允许单元格在表格的多列之间占据空间。它反映 colspan 属性。

HTMLTableCellElement.headers 只读

一个描述与单元格相关联的由 <th>id 构成的表头列表的 DOMTokenList。它反映 headers 属性。

HTMLTableCellElement.rowSpan

一个指示此单元格必须跨越行数的正数;这允许单元格在表格的多行之间占据空间。它反映 rowspan 属性。

HTMLTableCellElement.scope

一个指示 <th> 单元格范围的字符串。scope 可能的值有:colcolgrouprowrowgroup 或空字符串("")。

实例方法

没有特定的方法,从其父接口 HTMLElement 继承方法。

已弃用的属性

警告: 这些属性已弃用,不应再使用。它们被记录下来主要是为了帮助理解旧的代码库。

HTMLTableCellElement.align 已弃用

一个包含 align 属性的值的字符串(如果存在),或者如果未设置,则为空字符串。其用于设置元素内容相对于周围 "left""right""center" 上下文的对齐方式。请使用 CSS text-align 属性代替。

HTMLTableCellElement.axis 已弃用

一个包含虚拟中单元格分组名称的字符串。它反映已过时的 axis 属性。

HTMLTableCellElement.bgColor 已弃用

一个包含单元格背景色的字符串。它反映已过时的 bgColor 属性。

HTMLTableCellElement.ch 已弃用

一个包含单字符的字符串。这个字符是用来对齐某一列所有单元格内容的基准。它反映 char 并默认为与语言相关的小数点,例如,英语的默认值为 '.',法语的默认值为 ','。此属性是可选的,而且没有得到很好的支持。

HTMLTableCellElement.chOff 已弃用

一个包含整数的字符串,表示由 HTMLTableRowElement.ch 定义的字符的右侧(对于从左到右的文本;或者对于从右到左的文本的左侧)必须保留多少个字符。此属性是可选的,并没有得到很好的支持。

HTMLTableCellElement.height 已弃用

一个包含单元格提示高度的像素长度的字符串。此属性反映已过时的 height 属性。

HTMLTableCellElement.noWrap 已弃用

一个反映 nowrap 属性,且支持是否单元格内容可以分成几行的布尔值。

HTMLTableCellElement.vAlign 已弃用

一个表示枚举值的字符串,指示单元格内容必须如何对齐。它反映 valign 属性,可以为以下值之一:"top""middle""bottom""baseline"。请使用 CSS vertical-align 属性代替。

HTMLTableCellElement.width 已弃用

如果可能的话,是一个指定应绘制单元格宽度的像素数的字符串。此属性反映已过时的 width 属性。使用 CSS width 属性代替。

规范

Specification
HTML
# htmltablecellelement

浏览器兼容性

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
HTMLTableCellElement
abbr
align
Deprecated
axis
Deprecated
bgColor
Deprecated
cellIndex
ch
Deprecated
chOff
Deprecated
colSpan
headers
height
Deprecated
noWrap
Deprecated
rowSpan
scope
vAlign
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.

参见

  • 实现此接口的 HTML 元素:<tr><td>