HTMLTableElement

属性

继承自父接口 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 异常。

规范

浏览器兼容性

参见

• 实现了这个接口的 HTML 元素：<table>。