HTMLTableRowElement

Baseline 广泛可用 *

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

* 此特性的某些部分可能存在不同级别的支持。

HTMLTableRowElement 接口提供了特殊属性和方法(除了它通过继承获得的 HTMLElement 接口之外),用于操作 HTML 表格中行的布局和表示。

EventTarget Node Element HTMLElement HTMLTableRowElement

实例属性

继承自其父级 HTMLElement 的属性。

HTMLTableRowElement.cells 只读

返回一个包含行中单元格的实时 HTMLCollectionHTMLCollection 是实时的,当添加或删除单元格时会自动更新。

HTMLTableRowElement.rowIndex 只读

返回一个数字,表示该行在整个表格中的逻辑位置。如果该行不属于任何表格,则返回 -1

HTMLTableRowElement.sectionRowIndex 只读

返回一个数字,表示该行在其所属的表格部分中的逻辑位置。如果该行不属于任何部分,则返回 -1

实例方法

继承自其父级 HTMLElement 的方法.

HTMLTableRowElement.deleteCell()

删除与 index 对应的单元格。如果 index-1,则删除行的最后一个单元格。如果 index 小于 -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"

规范

规范
HTML
# htmltablerowelement

浏览器兼容性

另见

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