HTMLTableElement
基线 广泛可用
此功能非常成熟,可以在许多设备和浏览器版本上正常工作。它从 2015 年 7 月.
报告反馈
实例属性
HTMLTableElement
接口提供了特殊的属性和方法(除了通过继承可用的常规 HTMLElement
对象接口之外),用于操作 HTML 文档中表格的布局和呈现。
-
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
。设置时,如果对象不表示一个<tfoot>
,则会抛出一个名为HierarchyRequestError
的DOMException
。如果给定一个正确的对象,则将其插入到树中,紧接在第一个既不是<caption>
,也不是<colgroup>
,也不是<thead>
的元素之前,或者如果不存在此类元素则作为最后一个子元素,并且第一个作为此元素子元素的<tfoot>
将从树中删除,如果有的话。 - 返回一个包含元素所有行的实时
HTMLCollection
,即所有作为元素子元素的<tr>
,或者其<thead>
,<tbody>
和<tfoot>
子元素的子元素。<thead>
成员在树中以树状顺序出现,<tbody>
成员最后出现,也是以树状顺序出现。HTMLCollection
是实时的,并且在HTMLTableElement
更改时会自动更新。
返回一个包含元素所有 <tbody>
的实时 HTMLCollection
。HTMLCollection
是实时的,并且在 HTMLTableElement
更改时会自动更新。
已弃用属性
- 警告: 以下属性已弃用。您应该避免使用它们。
- 一个字符串,包含一个枚举值,反映了
align
属性。它指示元素内容相对于周围环境的对齐方式。可能的值为"left"
、"right"
和"center"
。 - 一个字符串,包含单元格的背景颜色。它反映了已弃用的
bgColor
属性。 - 一个字符串,包含表格边框的像素宽度。它反映了已弃用的
border
属性。 - 一个字符串,包含单元格内容与单元格边框之间水平和垂直间距的像素宽度。它反映了已弃用的
cellpadding
属性。 -
一个包含水平和垂直单元格间距(以像素为单位)的字符串。它反映了已过时的
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()
-
返回一个
HTMLTableSectionElement
,表示元素的第一个<thead>
子元素。如果未找到,则会创建一个新的元素并将其插入到树中,位于第一个不是<caption>
也不<colgroup>
的元素之前,或者如果不存在这样的元素,则将其插入到最后一个子元素。 HTMLTableElement.deleteTHead()
-
删除元素的第一个
<thead>
子元素。 HTMLTableElement.createTFoot()
-
返回一个
HTMLTableSectionElement
,表示元素的第一个<tfoot>
子元素。如果未找到,则会创建一个新的元素并将其插入到树中,作为最后一个子元素。 HTMLTableElement.deleteTFoot()
-
删除元素的第一个
<tfoot>
子元素。 HTMLTableElement.createTBody()
-
返回一个
HTMLTableSectionElement
,表示元素的一个新的<tbody>
子元素。它被插入到树中,位于最后一个<tbody>
元素之后,或者如果不存在这样的元素,则将其插入到最后一个子元素。 -
返回一个
HTMLElement
,表示元素的第一个<caption>
子元素。如果未找到,则会创建一个新的元素并将其插入到树中,作为<table>
元素的第一个子元素。 -
删除元素的第一个
<caption>
子元素。 HTMLTableElement.insertRow()
-
返回一个
HTMLTableRowElement
,表示表格中的一行新行。它将新行插入到行集合中,位于给定index
位置的<tr>
元素之前。如果需要,则会创建一个<tbody>
。如果index
为-1
,则新行将被追加到集合的末尾。如果index
小于-1
或大于集合中的行数,则会抛出具有IndexSizeError
值的DOMException
。 HTMLTableElement.deleteRow()
-
删除对应于参数中给定
index
的行。如果index
值为-1
,则删除最后一行;如果它小于-1
或大于集合中的行数,则会抛出具有IndexSizeError
值的DOMException
。
规范
规范 |
---|
HTML 标准 # htmltableelement |
浏览器兼容性
BCD 表格仅在浏览器中加载
另请参阅
- 实现此接口的 HTML 元素:
<table>
。