HTMLTableElement
The HTMLTableElement
interface provides special properties and methods (beyond the regular HTMLElement
object interface it also has available to it by inheritance) for manipulating the layout and presentation of tables in an HTML document.
Instance properties
Inherits properties from its parent, HTMLElement
.
-
A
HTMLTableCaptionElement
representing the first<caption>
that is a child of the element, ornull
if none is found. When set, if the object doesn't represent a<caption>
, aDOMException
with theHierarchyRequestError
name is thrown. If a correct object is given, it is inserted in the tree as the first child of this element and the first<caption>
that is a child of this element is removed from the tree, if any. HTMLTableElement.tHead
-
A
HTMLTableSectionElement
representing the first<thead>
that is a child of the element, ornull
if none is found. When set, if the object doesn't represent a<thead>
, aDOMException
with theHierarchyRequestError
name is thrown. If a correct object is given, it is inserted in the tree immediately before the first element that is neither a<caption>
, nor a<colgroup>
, or as the last child if there is no such element, and the first<thead>
that is a child of this element is removed from the tree, if any. HTMLTableElement.tFoot
-
A
HTMLTableSectionElement
representing the first<tfoot>
that is a child of the element, ornull
if none is found. When set, if the object doesn't represent a<tfoot>
, aDOMException
with theHierarchyRequestError
name is thrown. If a correct object is given, it is inserted in the tree immediately before the first element that is neither a<caption>
, a<colgroup>
, nor a<thead>
, or as the last child if there is no such element, and the first<tfoot>
that is a child of this element is removed from the tree, if any. HTMLTableElement.rows
Read only-
Returns a live
HTMLCollection
containing all the rows of the element, that is all<tr>
that are a child of the element, or a child of one of its<thead>
,<tbody>
and<tfoot>
children. The rows members of a<thead>
appear first, in tree order, and those members of a<tbody>
last, also in tree order. TheHTMLCollection
is live and is automatically updated when theHTMLTableElement
changes. HTMLTableElement.tBodies
Read only-
Returns a live
HTMLCollection
containing all the<tbody>
of the element. TheHTMLCollection
is live and is automatically updated when theHTMLTableElement
changes.
Obsolete Properties
Warning: The following properties are obsolete. You should avoid using them.
HTMLTableElement.align
Deprecated-
A string containing an enumerated value reflecting the
align
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
Deprecated-
A string containing the background color of the cells. It reflects the obsolete
bgColor
attribute. HTMLTableElement.border
Deprecated-
A string containing the width in pixels of the border of the table. It reflects the obsolete
border
attribute. HTMLTableElement.cellPadding
Deprecated-
A string containing the width in pixels of the horizontal and vertical space between cell content and cell borders. It reflects the obsolete
cellpadding
attribute. HTMLTableElement.cellSpacing
Deprecated-
A string containing the width in pixels of the horizontal and vertical separation between cells. It reflects the obsolete
cellspacing
attribute. HTMLTableElement.frame
Deprecated-
A string containing the type of the external borders of the table. It reflects the obsolete
frame
attribute and can take one of the following values:"void"
,"above"
,"below"
,"hsides"
,"vsides"
,"lhs"
,"rhs"
,"box"
, or"border"
. HTMLTableElement.rules
Deprecated-
A string containing the type of the internal borders of the table. It reflects the obsolete
rules
attribute and can take one of the following values:"none"
,"groups"
,"rows"
,"cols"
, or"all"
. HTMLTableElement.summary
Deprecated-
A string containing a description of the purpose or the structure of the table. It reflects the obsolete
summary
attribute. HTMLTableElement.width
Deprecated-
A string containing the length in pixels or in percentage of the desired width of the entire table. It reflects the obsolete
width
attribute.
Instance methods
Inherits methods from its parent, HTMLElement
.
HTMLTableElement.createTHead()
-
Returns an
HTMLTableSectionElement
representing the first<thead>
that is a child of the element. If none is found, a new one is created and inserted in the tree immediately before the first element that is neither a<caption>
, nor a<colgroup>
, or as the last child if there is no such element. HTMLTableElement.deleteTHead()
-
Removes the first
<thead>
that is a child of the element. HTMLTableElement.createTFoot()
-
Returns an
HTMLTableSectionElement
representing the first<tfoot>
that is a child of the element. If none is found, a new one is created and inserted in the tree as the last child. HTMLTableElement.deleteTFoot()
-
Removes the first
<tfoot>
that is a child of the element. HTMLTableElement.createTBody()
-
Returns a
HTMLTableSectionElement
representing a new<tbody>
that is a child of the element. It is inserted in the tree after the last element that is a<tbody>
, or as the last child if there is no such element. -
Returns an
HTMLElement
representing the first<caption>
that is a child of the element. If none is found, a new one is created and inserted in the tree as the first child of the<table>
element. -
Removes the first
<caption>
that is a child of the element. HTMLTableElement.insertRow()
-
Returns an
HTMLTableRowElement
representing a new row of the table. It inserts it in the rows collection immediately before the<tr>
element at the givenindex
position. If necessary a<tbody>
is created. If theindex
is-1
, the new row is appended to the collection. If theindex
is smaller than-1
or greater than the number of rows in the collection, aDOMException
with the valueIndexSizeError
is raised. HTMLTableElement.deleteRow()
-
Removes the row corresponding to the
index
given in parameter. If theindex
value is-1
the last row is removed; if it is smaller than-1
or greater than the amount of rows in the collection, aDOMException
with the valueIndexSizeError
is raised.
Specifications
Specification |
---|
HTML Standard # htmltableelement |
Browser compatibility
BCD tables only load in the browser
See also
- The HTML element implementing this interface:
<table>
.