HTMLTableElement
The HTMLTableElement
interface provides special properties and methods (beyond the regular HTMLElement
(en-US) object interface it also has available to it by inheritance) for manipulating the layout and presentation of tables in an HTML document.
Properties
Inherits properties from its parent, HTMLElement
(en-US).
HTMLTableElement.caption
(en-US)- Is a
HTMLTableCaptionElement
(en-US) 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
(en-US) 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
(en-US)- Is a
HTMLTableSectionElement
(en-US) representing the first<thead>
(en-US) that is a child of the element, ornull
if none is found. When set, if the object doesn't represent a<thead>
, aDOMException
(en-US) 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>
(en-US), 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
(en-US)- Is a
HTMLTableSectionElement
(en-US) representing the first<tfoot>
(en-US) that is a child of the element, ornull
if none is found. When set, if the object doesn't represent a<tfoot>
, aDOMException
(en-US) 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>
(en-US), nor a<thead>
(en-US), 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
(en-US)Schreibgeschützt- 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>
(en-US),<tbody>
(en-US) and<tfoot>
(en-US) 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
(en-US)Schreibgeschützt- Returns a live
HTMLCollection
containing all the<tbody>
(en-US) 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
(en-US)- 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
(en-US)- Is a
DOMString
containing the background color of the cells. It reflects the obsoletebgcolor
attribute. HTMLTableElement.border
(en-US)- Is a
DOMString
containing the width in pixels of the border of the table. It reflects the obsoleteborder
attribute. HTMLTableElement.cellPadding
(en-US)- 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
(en-US)- Is a
DOMString
containing the width in pixels of the horizontal and vertical separation between cells. It reflects the obsoletecellspacing
attribute. HTMLTableElement.frame
(en-US)- 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
(en-US)- 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
(en-US)- Is a
DOMString
containing a description of the purpose or the structure of the table. It reflects the obsoletesummary
attribute. HTMLTableElement.width
(en-US)- Is a
DOMString
containing the length in pixels or in percentage of the desired width fo the entire table. It reflects the obsoletewidth
attribute.
Methods
Inherits methods from its parent, HTMLElement
(en-US).
HTMLTableElement.createTHead()
(en-US)- Returns an
HTMLElement
(en-US) representing the first<thead>
(en-US) 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>
(en-US), or as the last child if there is no such element. HTMLTableElement.deleteTHead()
(en-US)- Removes the first
<thead>
(en-US) that is a child of the element. HTMLTableElement.createTFoot()
(en-US)- Returns an
HTMLElement
(en-US) representing the first<tfoot>
(en-US) 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>
, a<colgroup>
(en-US), nor a<thead>
(en-US), or as the last child if there is no such element. HTMLTableElement.deleteTFoot()
(en-US)- Removes the first
<tfoot>
(en-US) that is a child of the element. HTMLTableElement.createCaption()
- Returns an
HTMLElement
(en-US) 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. HTMLTableElement.deleteCaption()
(en-US)- Removes the first
<caption>
that is a child of the element. HTMLTableElement.insertRow()
- Returns an
HTMLTableRowElement
(en-US) 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>
(en-US) 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
(en-US) with the valueIndexSizeError
is raised. HTMLTableElement.deleteRow()
(en-US)- Removes the row corresponding to the
index
given in parameter. If theindex
value is-1
the last row is removed; if it smaller than-1
or greater than the amount of rows in the collection, aDOMException
(en-US) with the valueIndexSizeError
is raised.
Specifications
Specification | Status | Comment |
---|---|---|
HTML Living Standard Die Definition von 'HTMLTableElement' in dieser Spezifikation. |
Lebender Standard | Added the sortable property and the stopSorting() method. |
HTML5 Die Definition von 'HTMLTableElement' in dieser Spezifikation. |
Empfehlung | Added the createTBody() method. |
Document Object Model (DOM) Level 2 HTML Specification Die Definition von 'HTMLTableElement' in dieser Spezifikation. |
Veraltet | Defined when caption , tHead , tFoot , insertRow() , and deleteRow() raise exceptions. |
Document Object Model (DOM) Level 1 Specification Die Definition von 'HTMLTableElement' in dieser Spezifikation. |
Veraltet | Initial definition. |
Browser compatibility
BCD tables only load in the browser
See also
- The HTML element implementing this interface:
<table>
.