HTMLTableElement - 表示 <table> 元素

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

属性

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

HTMLTableElement.caption

一个 HTMLTableCaptionElement，表示该元素子元素中的第一个 <caption> 元素，如果没有，则为 null。设置该值时，如果对象不是一个 <caption>，则抛出带有 HierarchyRequestError 名称的 DOMException。如果给出了正确的对象，则将其作为该元素的第一个子元素插入树中，并且从树中删除作为此元素的子元素的第一个 <caption>（如果有的话）。

HTMLTableElement.tHead

一个 HTMLTableSectionElement，表示该元素子元素中的第一个 <thead> 元素，如果没有，则为 null。设置该值时，如果对象不是一个 <thead>，则抛出具有 HierarchyRequestError 名称的 DOMException。如果给出了正确的对象，它将被插入到第一个特定元素之前的树中，该元素不是 <caption>、<colgroup>，或者最后一个元素。如果没有这样的元素，则将从子树中移除第一个 <thead> 作为此元素的子元素（如果有的话）。

HTMLTableElement.tFoot

一个 HTMLTableSectionElement，表示该元素子元素中的第一个 <tfoot> 元素，如果没有，则为 null。设置该值时，如果对象不是一个 <tfooter>，则抛出具有 HierarchyRequestError 名称的 DOMException。如果给出了正确的对象，它将被插入到第一个特定元素之前的树中，该元素不是 <caption>、<colgroup>、<thead>，或者如果没有这样的元素，则作为最后一个子元素，并且从树中删除第一个 <tfoot> 这个元素的子元素（如果有的话）。

HTMLTableElement.rows只读

返回一个实时的 HTMLCollection，包含元素的所有行，即该元素所有的 <tr> 子元素，或者是其 <thead>，<tbody> 和 <tfoot> 中的 <tr> 元素。行的成员中，按照树的顺序，首先是 <thead> 中的 <tr>，最后是 <tbody> 中的 <tr>，也是按树的顺序出现。该 HTMLCollection 是实时的，当 HTMLTableElement 改变时会自动更新。

HTMLTableElement.tBodies只读

返回一个实时的 HTMLCollection，包含该元素的所有 <tbody>，该 HTMLCollection 是实时的，当 HTMLTableElement 改变时会自动更新。

HTMLTableElement.sortable

一个 Boolean，指示是否允许用户代理为表提供排序机制（如果它支持此类功能）。该属性反映了 sortable 属性。

HTMLTableElement.align

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

HTMLTableElement.bgColor

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

HTMLTableElement.border

一个 DOMString，包含表格边框的宽度（以像素为单位）。它反映了过时的border 属性。

HTMLTableElement.cellPadding

一个 DOMString，包含单元格内容和单元格边框之间水平和垂直空白的宽度（以像素为单位）。它反映了过时的 cellpadding 属性。

HTMLTableElement.cellSpacing

一个 DOMString，包含单元格之间水平和垂直间隔的宽度（以像素为单位）。它反映了过时的 cellspacing 属性。

HTMLTableElement.frame

一个 DOMString，包含表格的外部边框的类型。它反映了过时的 frame 属性，可以采用以下值之一："void"，"above"，"below"，"hsides"，"vsides"，"lhs"，"rhs"，"box" 和 "border"。

HTMLTableElement.rules

一个 DOMString，包含表格的内部边框的类型。它反映了过时的 rules 属性，可以采用以下值之一："none"，"groups"，"rows"，"cols" 和 "all"。

HTMLTableElement.summary

一个 DOMString，包含表格的目的或结构的描述。它反映了过时的 summary 属性。

HTMLTableElement.width

一个 DOMString 包含整个表格的长度（以像素为单位）或所需宽度的百分比。它反映了过时的 width 属性。

方法

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

HTMLTableElement.createTHead()

返回一个 HTMLElement，表示元素子元素中的第一个 <thead>。如果没有找到该元素，则创建一个新的并在第一个特定元素之前的树中插入，该元素既不是 <caption>，也不是 <colgroup>，或者如果没有这样的元素，则作为最后一个子元素。

HTMLTableElement.deleteTHead()

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

HTMLTableElement.createTFoot()

返回一个 HTMLElement，表示元素子元素中的第一个 <tfoot>。如果没有找到该元素，则创建一个新的并在第一个特定元素之前的树中插入，该元素既不是 <caption>，也不是 <colgroup>、<thead>，或者如果没有这样的元素，则作为最后一个子元素。

HTMLTableElement.deleteTFoot()

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

HTMLTableElement.createCaption()

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

HTMLTableElement.deleteCaption()

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

HTMLTableElement.insertRow()

返回一个 HTMLTableRowElement，表示表格的新行。它将它插入到位于给定 index 位置的 <tr> 元素之前的 rows 集合中。如有必要，则创建 <tbody>。如果 index 是 -1，则新行将附加到集合最后一行。如果 index 小于 -1 或大于集合中的行数，则引发值为 IndexSizeError 的 DOMException。

HTMLTableElement.deleteRow()

删除参数中给出的 index 对应的行。如果 index 值为 -1 ，则删除最后一行；如果它小于 -1 或大于集合中的行数，则引发值为 IndexSizeError 的 DOMException。

HTMLTableElement.stopSorting()

删除表格的所有 <th> 元素的 sortable 属性。

规范

规范	状态	备注
HTML Living Standard HTMLTableElement 的定义	现行的标准	添加了 sortable 属性和 stopSorting() 方法。
HTML5 HTMLTableElement 的定义	推荐	添加了 createTBody() 方法。
Document Object Model (DOM) Level 2 HTML Specification HTMLTableElement 的定义	已过时	定义了 caption ，tHead，tFoot，insertRow() 和 deleteRow() 如何引发异常。
Document Object Model (DOM) Level 1 Specification HTMLTableElement 的定义	已过时	初始定义。

桌面浏览器兼容性

移动浏览器兼容性

1. 从 Firefox 20 开始，索引参数已成为可选参数，默认为 -1，符合 HTML 规范。

相关链接

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