HTMLTableRowElement - 表示 <tr> 元素

HTMLTableRowElement 接口提供了特殊的属性和方法（除了通过继承通用的 HTMLElement 接口获得的常规属性和方法）来操作 HTML 表格中行的布局和表示。

属性

从其父接口 HTMLElement 继承了属性。

HTMLTableRowElement.align

一个 DOMString，其中包含反映 align 属性的枚举值。它表示元素内容相对于周围环境的对齐。可能的值是 "left"，"right" 和"center"`。

HTMLTableRowElement.bgColor

一个 DOMString 包含单元格的背景颜色。它反映了过时的 bgcolor 属性。

HTMLTableRowElement.cells 只读

返回包含行中单元格的实时 HTMLCollection。 HTMLCollection 是实时的，并在添加或删除单元格时自动更新。

HTMLTableRowElement.ch

一个 DOMString，包含一个单个字符。此字符是用于对齐列的所有单元格的字符。它反映了 char，默认为与该语言相关的小数点，例如英语的 '.'，法语的 ','。此属性是可选的，并且在浏览器中得不到很好的支持。

HTMLTableRowElement.chOff

一个 DOMString，其中包含一个整数，表示必须在 HTMLTableRowElement.ch 定义的字符右侧（从左到右的脚本; 或左侧为从右到左的脚本）留下多少个字符。

HTMLTableRowElement.rowIndex 只读

返回一个 long 值，它给出整个表格中该行的逻辑位置。如果该行不是表格的一部分，则返回 -1。

HTMLTableRowElement.sectionRowIndex 只读

返回一个 long 值，它给出了它所属的表格章节（section）中该行的逻辑位置。如果该行不是章节的一部分，则返回 -1。

HTMLTableRowElement.vAlign

一个 DOMString 枚举值，表示单元格的内容必须如何垂直对齐。它反映了 valign 属性，并且可以具有以下值之一："top"，"middle"，"bottom" 或 "baseline"。

方法

从其父接口 HTMLElement 继承了方法。

HTMLTableRowElement.deleteCell()

删除行中给定位置的单元格。如果给定位置比行中的单元格数量更大（或者等于，因为是从零开始计算的），或小于 0，则它会引发值为 IndexSizeError 的 DOMException 值。

HTMLTableRowElement.insertCell()

在行的给定位置之前插入一个新单元格。如果没有给定的位置，或者给出的是 -1，它会将单元格附加到行结尾。如果给定位置比行中的单元格数量大（或者等于，因为是从零开始计算的），或者小于 -1，，则它会引发值为 IndexSizeError 的 DOMException 值。它返回对 HTMLTableCellElement 的引用。

规范

规范	状态	备注
HTML Living Standard HTMLTableRowElement 的定义	现行的标准	-
HTML5 HTMLTableRowElement 的定义	推荐	insertCell的参数现在是可选的，默认为 -1。
Document Object Model (DOM) Level 2 HTML Specification HTMLTableRowElement 的定义	已过时	cells，rowIndex 和 selectionRowIndex 属性现在是只读的。 insertCell 和 deleteCell 方法可能引发异常。
Document Object Model (DOM) Level 1 Specification HTMLTableRowElement 的定义	已过时	初始定义。

桌面浏览器兼容性

移动浏览器兼容性

相关链接

• 实现该接口的 HTML 元素：<tr>。