HTMLTableElement
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
* Some parts of this feature may have varying levels of support.
HTMLTableElement
接口在常用的 HTMLElement
接口的基础上,提供了专门的属性和方法来处理 HTML 文档中表格的布局与展示。通过继承,它也可以访问父接口 HTMLElement
中的成员。
属性
继承自父接口,HTMLElement
。
HTMLTableElement.caption
-
这是一个
HTMLTableCaptionElement
,表示作为子元素中的第一个<caption>
,如果找不到则为null
。当设置此属性时,如果给出的对象不是一个<caption>
,一个带有HierarchyRequestError
名字的异常DOMException
会被抛出。如果设置了正确的对象,它会被作为第一个子元素插入 DOM 树中,同时子元素中的第一个<caption>
会被移除,如果存在的话。 HTMLTableElement.tHead
-
这是一个
HTMLTableSectionElement
,表示子元素中的第一个<thead>
,如果找不到则为null
。当设置此属性时,如果给出的对象不是一个<thead>
,一个带有HierarchyRequestError
名字的异常DOMException
会被抛出。如果设置了正确的对象,它会被立即插入到 DOM 树中既不是<caption>
也不是<colgroup>
的第一个元素之前,或者直接被作为最后一个元素插入(如果找不到上述元素的话),同时子元素中的第一个<thead>
会被移除,如果存在的话。 HTMLTableElement.tFoot
-
这是一个
HTMLTableSectionElement
,表示子元素中的第一个<tfoot>
,如果找不到则为null
。当设置此属性时,如果给出的对象不是一个<tfoot>
,一个带有HierarchyRequestError
名字的异常DOMException
会被抛出。如果设置了正确的对象,它会被立即插入到 DOM 树中既不是<caption>
、<colgroup>
也不是<thead>
的第一个元素之前,或者直接被作为最后一个元素插入(如果找不到上述元素的话),同时子元素中的第一个<tfoot>
会被移除,如果存在的话。 HTMLTableElement.rows
只读-
返回一个实时的
HTMLCollection
,它包含元素中的所有行,也就是子元素中的所有<tr>
,或者是<thead>
、<tbody>
和<tfoot>
三者子元素中的其中一个子元素。<thead>
中的行会按照 DOM 树的顺序出现在首位,<tbody>
中的行出现在末位,也会按照 DOM 树的顺序。HTMLCollection
对象是实时的,当HTMLTableElement
发生变化时会自动更新。 HTMLTableElement.tBodies
只读-
返回一个实时的
HTMLCollection
,它包含元素中所有的<tbody>
。HTMLCollection
对象是实时的,当HTMLTableElement
发生变化时会自动更新。
过时的属性
警告: 以下属性已经过时,应当避免使用它们。
HTMLTableElement.align
已弃用-
Is a
DOMString
containing an enumerated value reflecting thealign
attribute. It indicates the alignment of the element's contents with respect to the surrounding context. The possible values are"left"
,"right"
, and"center"
. HTMLTableElement.bgColor
已弃用-
Is a
DOMString
containing the background color of the cells. It reflects the obsoletebgcolor
attribute. HTMLTableElement.border
已弃用-
Is a
DOMString
containing the width in pixels of the border of the table. It reflects the obsoleteborder
attribute. HTMLTableElement.cellPadding
已弃用-
Is a
DOMString
containing the width in pixels of the horizontal and vertical sapce between cell content and cell borders. It reflects the obsoletecellpadding
attribute. HTMLTableElement.cellSpacing
已弃用-
Is a
DOMString
containing the width in pixels of the horizontal and vertical separation between cells. It reflects the obsoletecellspacing
attribute. HTMLTableElement.frame
已弃用-
Is a
DOMString
containing the type of the external borders of the table. It reflects the obsoleteframe
attribute and can take one of the following values:"void"
,"above"
,"below"
,"hsides"
,"vsides"
,"lhs"
,"rhs"
,"box"
, or"border"
. HTMLTableElement.rules
已弃用-
Is a
DOMString
containing the type of the internal borders of the table. It reflects the obsoleterules
attribute and can take one of the following values:"none"
,"groups"
,"rows"
,"cols"
, or"all"
. HTMLTableElement.summary
已弃用-
Is a
DOMString
containing a description of the purpose or the structure of the table. It reflects the obsoletesummary
attribute. HTMLTableElement.width
已弃用-
Is a
DOMString
containing the length in pixels or in percentage of the desired width fo the entire table. It reflects the obsoletewidth
attribute.
方法
继承自父接口,HTMLElement
。
HTMLTableElement.createTHead()
-
返回一个
HTMLElement
,表示子元素中的第一个<thead>
。如果找不到,则创建一个新的并且立即插入到 DOM 树中既不是<caption>
也不是<colgroup>
的第一个元素之前,或者直接被作为最后一个元素插入(如果找不到上述元素的话)。 HTMLTableElement.deleteTHead()
-
移除子元素中的第一个
<thead>
。 HTMLTableElement.createTFoot()
-
返回一个
HTMLElement
,表示子元素中的第一个<tfoot>
。如果找不到,则创建一个新的并且立即插入到 DOM 树中既不是<caption>
、<colgroup>
也不是<thead>
的第一个元素之前,或者直接被作为最后一个元素插入(如果找不到上述元素的话)。 HTMLTableElement.deleteTFoot()
-
移除子元素中的第一个
<tfoot>
。 HTMLTableElement.createCaption()
-
返回一个
HTMLElement
,表示子元素中的第一个<caption>
。如果找不到,则创建一个新的并且插入到 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
会发生。
规范
Specification |
---|
HTML # htmltableelement |
浏览器兼容性
参见
- 实现了这个接口的 HTML 元素:
<table>
。