此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

HTMLTableRowElement

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

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

>

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>
# htmltablerowelement>

浏览器兼容性

参见

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