View in EnglishAlways switch to English

HTMLTableElement

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.

HTMLTableElement 接口提供了特殊属性和方法（除继承自常规HTMLElement 对象接口的功能外），用于操作 HTML 文档中表格的布局与呈现效果。

属性

继承自父接口HTMLElement。

HTMLTableElement.caption: 表示该元素首个子元素<caption> 的HTMLTableCaptionElement 对象，若未找到则返回null。当设置此属性时，若对象不代表<caption> 元素，则抛出名称为HierarchyRequestError 的DOMException 异常。若提供正确的对象，则将其插入树中作为该元素的首个子元素，同时移除树中该元素的首个<caption> 子元素（若存在）。
HTMLTableElement.tHead: 表示该元素首个子元素<thead> 的HTMLTableSectionElement 对象，若未找到则返回null。当设置此属性时，若对象不代表<thead> 元素，则抛出名称为HierarchyRequestError 的DOMException 异常。若提供正确的对象，则将其插入树结构中：若存在既非<caption> 也非<colgroup> 的首个元素，则置于该元素之前；若不存在此类元素，则作为最后一个子元素插入。同时，若存在该元素的首个子元素为<thead>，则将其从树结构中移除。
HTMLTableElement.tFoot: 表示该元素首个子元素<tfoot> 的HTMLTableSectionElement 对象，若未找到则返回null。当设置此属性时，若对象不代表<tfoot> 元素，则抛出名称为HierarchyRequestError 的DOMException 异常。若提供正确的对象，则将其插入树结构中，位置紧邻首个既非<caption>、<colgroup> 且非<thead> 的元素之前插入树中；若不存在此类元素，则作为最后一个子元素插入。同时，若存在该元素的首个子元素为<tfoot>，则将其从树结构中移除。
HTMLTableElement.rows只读: 返回一个包含元素所有行（即该元素的所有<tr> 子元素，或其某个<thead>、<tbody> 或<tfoot> 元素的子元素）的实时HTMLCollection。<thead> 的行成员按树结构顺序优先呈现，<tbody> 的行成员按树结构顺序最后呈现。该HTMLCollection 为实时集合，当HTMLTableElement 发生变更时会自动更新。
HTMLTableElement.tBodies只读: 返回一个实时的HTMLCollection，它包含元素中所有的<tbody>。该HTMLCollection 为实时集合，当HTMLTableElement 发生变更时会自动更新。

过时的属性

警告：以下属性已经过时，应当避免使用它们。

HTMLTableElement.align已弃用: 包含枚举值的字符串，反映了 align 属性。它表示元素内容相对于周围环境的对齐方式。可能的值有"left"、"right" 和"center"。
HTMLTableElement.bgColor已弃用: 包含单元格背景颜色的字符串。它反映已过时的 bgColor 属性。
HTMLTableElement.border已弃用: 包含表格边框像素宽度的字符串。它反映已过时的 border 属性。
HTMLTableElement.cellPadding已弃用: 包含表格边框像素宽度的字符串。它反映已过时的 cellpadding 属性。
HTMLTableElement.cellSpacing已弃用: 包含单元格内容与单元格边框之间水平和垂直间距像素宽度的字符串。它反映已过时的 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(): 返回表示子元素中的第一个<thead> 的HTMLTableSectionElement。如果找不到该元素，则创建一个新的并且立即插入到 DOM 树中既不是<caption> 也不是<colgroup> 的第一个元素之前，或者直接被作为最后一个元素插入（如果找不到上述元素的话）。
HTMLTableElement.deleteTHead(): 移除子元素中的第一个<thead>。
HTMLTableElement.createTFoot(): 返回表示子元素中的第一个<tfoot> 的HTMLTableSectionElement。如果找不到该元素，则创建一个新的并且立即插入到 DOM 树中既不是<caption>、<colgroup> 也不是<thead> 的第一个元素之前，或者直接被作为最后一个元素插入（如果找不到上述元素的话）。
HTMLTableElement.deleteTFoot(): 移除子元素中的第一个<tfoot>。
HTMLTableElement.createTBody(): 返回表示子元素中的第一个<tbody> 的HTMLTableSectionElement。该元素将插入到树结构中，位于最后一个<tbody> 元素之后；若不存在此类元素，则作为最后一个子元素插入。
HTMLTableElement.createCaption(): 返回表示子元素中的第一个<caption> 的HTMLElement。如果找不到该元素，则创建一个新的并且插入到 DOM 树中作为<table> 的第一个子元素。
HTMLTableElement.deleteCaption(): 移除子元素中的第一个<caption>。
HTMLTableElement.insertRow(): 返回表示表格中的一个新行的HTMLTableRowElement。它会被立即插入到行集合中给定index 位置所表示的<tr> 元素之前。如果有必要一个<tbody> 会被创建。如果index 值为-1，这个新行会被追加到集合中。如果index 值小于-1 或者大于集合中的行总数，则会抛出值为IndexSizeError 的DOMException 异常。
HTMLTableElement.deleteRow(): 移除与参数中给定index 值相关的行。如果index 值为-1，最后一行会被移除；如果index 值小于-1 或者大于集合中的行总数，则会抛出值为IndexSizeError 的DOMException 异常。