HTMLTableRowElement

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.

HTMLTableRowElement 接口提供用于操作 HTML 表格中行的布局和呈现的特定属性和方法(除了常规 HTMLElement 接口之外,它还可以通过继承来使用)。

EventTarget Node Element HTMLElement HTMLTableRowElement

实例属性

从其父接口 HTMLElement 继承属性。

HTMLTableRowElement.cells 只读

返回一个行中包含单元格的动态 HTMLCollectionHTMLCollection 是动态的,且当单元格添加或移除时可自动更新。

HTMLTableRowElement.rowIndex 只读

返回一个所在行相对于整个表格逻辑位置的数字。如果该行不属于表的一部分,则返回 -1

HTMLTableRowElement.sectionRowIndex 只读

返回一个所在行相对其所属表片段中逻辑位置的数字。如果该行不是片段的部分,则返回 -1

实例方法

从其父接口 HTMLElement 继承方法。

HTMLTableRowElement.deleteCell()

删除 index 对应的单元格。如果 index 值是 -1,则删除此行的最后一个单元格;如果索引小于 -1 或大于集合中单元格数量,引发值为 IndexSizeErrorDOMException

HTMLTableRowElement.insertCell()

返回一个表示此行新单元格的 HTMLTableCellElement。它将插入到单元格集合中给定索引(index)位置的元素之前。如果 index-1,则新单元格添加到集合末尾,如果 index 小于 -1 或大于集合的单元格数,则引发值为 IndexSizeErrorDOMException

已弃用的属性

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

HTMLTableRowElement.align 已弃用

一个反映 align 属性的字符串枚举值。其指示元素内容相对于周围上下文的对齐方式,可能的值有:"left""right""center"

HTMLTableRowElement.bgColor 已弃用

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

HTMLTableRowElement.ch 已弃用

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

HTMLTableRowElement.chOff 已弃用

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

HTMLTableRowElement.vAlign 已弃用

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

规范

Specification
HTML Standard
# htmltablerowelement

浏览器兼容性

BCD tables only load in the browser

参见

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