HTML DOM
HTMLTableElement 接口提供了特殊属性和方法(除继承自常规 HTMLElement 对象接口的功能外),用于操作 HTML 文档中表格的布局与呈现效果。
属性
继承自父接口 HTMLElement。
- HTMLTableElement.caption
- : 表示该元素首个子元素 caption 的 HTMLTableCaptionElement 对象,若未找到则返回
null。当设置此属性时,若对象不代表<caption>元素,则抛出名称为HierarchyRequestError的 DOMException 异常。若提供正确的对象,则将其插入树中作为该元素的首个子元素,同时移除树中该元素的首个<caption>子元素(若存在)。
- : 表示该元素首个子元素 caption 的 HTMLTableCaptionElement 对象,若未找到则返回
- HTMLTableElement.tHead
- : 表示该元素首个子元素 thead 的 HTMLTableSectionElement 对象,若未找到则返回
null。当设置此属性时,若对象不代表<thead>元素,则抛出名称为HierarchyRequestError的 DOMException 异常。若提供正确的对象,则将其插入树结构中:若存在既非 caption 也非 colgroup 的首个元素,则置于该元素之前;若不存在此类元素,则作为最后一个子元素插入。同时,若存在该元素的首个子元素为<thead>,则将其从树结构中移除。
- : 表示该元素首个子元素 thead 的 HTMLTableSectionElement 对象,若未找到则返回
- HTMLTableElement.tFoot
- : 表示该元素首个子元素 tfoot 的 HTMLTableSectionElement 对象,若未找到则返回
null。当设置此属性时,若对象不代表<tfoot>元素,则抛出名称为HierarchyRequestError的 DOMException 异常。若提供正确的对象,则将其插入树结构中,位置紧邻首个既非 caption、colgroup 且非 thead 的元素之前插入树中;若不存在此类元素,则作为最后一个子元素插入。同时,若存在该元素的首个子元素为<tfoot>,则将其从树结构中移除。
- : 表示该元素首个子元素 tfoot 的 HTMLTableSectionElement 对象,若未找到则返回
- HTMLTableElement.rows
- : 返回一个包含元素所有行(即该元素的所有 tr 子元素,或其某个 thead、tbody 或 tfoot 元素的子元素)的实时 HTMLCollection。
<thead>的行成员按树结构顺序优先呈现,<tbody>的行成员按树结构顺序最后呈现。该HTMLCollection为实时集合,当HTMLTableElement发生变更时会自动更新。
- : 返回一个包含元素所有行(即该元素的所有 tr 子元素,或其某个 thead、tbody 或 tfoot 元素的子元素)的实时 HTMLCollection。
- HTMLTableElement.tBodies
- : 返回一个实时的 HTMLCollection,它包含元素中所有的 tbody。该
HTMLCollection为实时集合,当HTMLTableElement发生变更时会自动更新。
- : 返回一个实时的 HTMLCollection,它包含元素中所有的 tbody。该
过时的属性
[!WARNING] 以下属性已经过时,应当避免使用它们。
- 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 异常。
- : 返回表示表格中的一个新行的 HTMLTableRowElement。它会被立即插入到行集合中给定
- HTMLTableElement.deleteRow()
- : 移除与参数中给定
index值相关的行。如果index值为-1,最后一行会被移除;如果index值小于-1或者大于集合中的行总数,则会抛出值为IndexSizeError的 DOMException 异常。
- : 移除与参数中给定
规范
浏览器兼容性
参见
- 实现了这个接口的 HTML 元素:table。
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
