大网数据广告活动
Web 标准与前端开发

HTMLTableElement

· 52CE 我爱测

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

HTML DOM

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 发生变更时会自动更新。

过时的属性

[!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 异常。
  • HTMLTableElement.deleteRow()
    • : 移除与参数中给定 index 值相关的行。如果 index 值为 -1,最后一行会被移除;如果 index 值小于 -1 或者大于集合中的行总数,则会抛出值为 IndexSizeError 的 DOMException 异常。

规范

浏览器兼容性

参见

  • 实现了这个接口的 HTML 元素:table。

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。