HTMLTableElement

基线 广泛可用

此功能非常成熟,可以在许多设备和浏览器版本上正常工作。它从 2015 年 7 月.

实例属性

HTMLTableElement 接口提供了特殊的属性和方法(除了通过继承可用的常规 HTMLElement 对象接口之外),用于操作 HTML 文档中表格的布局和呈现。

继承自父级 HTMLElement 的属性。

HTMLTableElement.caption

一个 HTMLTableCaptionElement,表示元素的第一个 <caption> 子元素,如果没有找到则为 null。设置时,如果对象不表示一个 <caption>,则会抛出一个名为 HierarchyRequestErrorDOMException。如果给定一个正确的对象,则将其插入到树中,作为此元素的第一个子元素,并且第一个作为此元素子元素的 <caption> 将从树中删除,如果有的话。

HTMLTableElement.tHead

一个 HTMLTableSectionElement,表示元素的第一个 <thead> 子元素,如果没有找到则为 null。设置时,如果对象不表示一个 <thead>,则会抛出一个名为 HierarchyRequestErrorDOMException。如果给定一个正确的对象,则将其插入到树中,紧接在第一个既不是 <caption> 也不是 <colgroup> 的元素之前,或者如果不存在此类元素则作为最后一个子元素,并且第一个作为此元素子元素的 <thead> 将从树中删除,如果有的话。

HTMLTableElement.tFoot

一个 HTMLTableSectionElement,表示元素的第一个 <tfoot> 子元素,如果没有找到则为 null。设置时,如果对象不表示一个 <tfoot>,则会抛出一个名为 HierarchyRequestErrorDOMException。如果给定一个正确的对象,则将其插入到树中,紧接在第一个既不是 <caption>,也不是 <colgroup>,也不是 <thead> 的元素之前,或者如果不存在此类元素则作为最后一个子元素,并且第一个作为此元素子元素的 <tfoot> 将从树中删除,如果有的话。

HTMLTableElement.rows 只读

返回一个包含元素所有行的实时 HTMLCollection,即所有作为元素子元素的 <tr>,或者其 <thead><tbody><tfoot> 子元素的子元素。<thead> 成员在树中以树状顺序出现,<tbody> 成员最后出现,也是以树状顺序出现。HTMLCollection 是实时的,并且在 HTMLTableElement 更改时会自动更新。

HTMLTableElement.tBodies 只读

返回一个包含元素所有 <tbody> 的实时 HTMLCollectionHTMLCollection 是实时的,并且在 HTMLTableElement 更改时会自动更新。

已弃用属性

警告: 以下属性已弃用。您应该避免使用它们。

HTMLTableElement.align 已弃用

一个字符串,包含一个枚举值,反映了 align 属性。它指示元素内容相对于周围环境的对齐方式。可能的值为 "left""right""center"

HTMLTableElement.bgColor 已弃用

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

HTMLTableElement.border 已弃用

一个字符串,包含表格边框的像素宽度。它反映了已弃用的 border 属性。

HTMLTableElement.cellPadding 已弃用

一个字符串,包含单元格内容与单元格边框之间水平和垂直间距的像素宽度。它反映了已弃用的 cellpadding 属性。

一个包含水平和垂直单元格间距(以像素为单位)的字符串。它反映了已过时的 cellspacing 属性。

HTMLTableElement.frame 已弃用

一个包含表格外部边框类型的字符串。它反映了已过时的 frame 属性,可以取以下值之一:"void""above""below""hsides""vsides""lhs""rhs""box""border"

HTMLTableElement.rules 已弃用

一个包含表格内部边框类型的字符串。它反映了已过时的 rules 属性,可以取以下值之一:"none""groups""rows""cols""all"

HTMLTableElement.summary 已弃用

一个包含表格目的或结构描述的字符串。它反映了已过时的 summary 属性。

HTMLTableElement.width 已弃用

一个包含整个表格所需宽度(以像素或百分比表示)的字符串。它反映了已过时的 width 属性。

实例方法

继承自其父级 HTMLElement 的方法.

HTMLTableElement.createTHead()

返回一个 HTMLTableSectionElement,表示元素的第一个 <thead> 子元素。如果未找到,则会创建一个新的元素并将其插入到树中,位于第一个不是 <caption> 也不 <colgroup> 的元素之前,或者如果不存在这样的元素,则将其插入到最后一个子元素。

HTMLTableElement.deleteTHead()

删除元素的第一个 <thead> 子元素。

HTMLTableElement.createTFoot()

返回一个 HTMLTableSectionElement,表示元素的第一个 <tfoot> 子元素。如果未找到,则会创建一个新的元素并将其插入到树中,作为最后一个子元素。

HTMLTableElement.deleteTFoot()

删除元素的第一个 <tfoot> 子元素。

HTMLTableElement.createTBody()

返回一个 HTMLTableSectionElement,表示元素的一个新的 <tbody> 子元素。它被插入到树中,位于最后一个 <tbody> 元素之后,或者如果不存在这样的元素,则将其插入到最后一个子元素。

HTMLTableElement.createCaption()

返回一个 HTMLElement,表示元素的第一个 <caption> 子元素。如果未找到,则会创建一个新的元素并将其插入到树中,作为 <table> 元素的第一个子元素。

HTMLTableElement.deleteCaption()

删除元素的第一个 <caption> 子元素。

HTMLTableElement.insertRow()

返回一个 HTMLTableRowElement,表示表格中的一行新行。它将新行插入到行集合中,位于给定 index 位置的 <tr> 元素之前。如果需要,则会创建一个 <tbody>。如果 index-1,则新行将被追加到集合的末尾。如果 index 小于 -1 或大于集合中的行数,则会抛出具有 IndexSizeError 值的 DOMException

HTMLTableElement.deleteRow()

删除对应于参数中给定 index 的行。如果 index 值为 -1,则删除最后一行;如果它小于 -1 或大于集合中的行数,则会抛出具有 IndexSizeError 值的 DOMException

规范

规范
HTML 标准
# htmltableelement

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅

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