HTMLTableRowElement
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.
The HTMLTableRowElement interface provides special properties and methods (beyond the HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of rows in an HTML table.
Instance properties
Inherits properties from its parent, HTMLElement.
HTMLTableRowElement.cellsRead only-
Returns a live
HTMLCollectioncontaining the cells in the row. TheHTMLCollectionis live and is automatically updated when cells are added or removed. HTMLTableRowElement.rowIndexRead only-
Returns a number that gives the logical position of the row within the entire table. If the row is not part of a table, returns
-1. HTMLTableRowElement.sectionRowIndexRead only-
Returns a number that gives the logical position of the row within the table section it belongs to. If the row is not part of a section, returns
-1.
Instance methods
Inherits methods from its parent, HTMLElement.
HTMLTableRowElement.deleteCell()-
Removes the cell corresponding to
index. Ifindexis-1, the last cell of the row is removed. Ifindexis less than-1or greater than the amount of cells in the collection, aDOMExceptionwith the valueIndexSizeErroris raised. HTMLTableRowElement.insertCell()-
Returns an
HTMLTableCellElementrepresenting a new cell of the row. The cell is inserted in the collection of cells immediately before the givenindexposition in the row. Ifindexis-1, the new cell is appended to the collection. Ifindexis less than-1or greater than the number of cells in the collection, aDOMExceptionwith the valueIndexSizeErroris raised.
Deprecated properties
Warning: These properties have been deprecated and should no longer be used. They are documented primarily to help understand older code bases.
HTMLTableRowElement.align-
A string containing an enumerated value reflecting the
alignattribute. It indicates the alignment of the element's contents to the surrounding context. The possible values are"left","right", and"center". HTMLTableRowElement.bgColor-
A string containing the background color of the cells. It reflects the obsolete
bgColorattribute. HTMLTableRowElement.ch-
A string containing one single character. This character is the one to align all the cells of a column on. It reflects the
charand defaults to the decimal points associated with the language, e.g.,'.'for English, or','for French. This property was optional and was not very well supported. HTMLTableRowElement.chOff-
A string containing an integer indicating how many characters must be left at the right (for left-to-right scripts; or at the left for right-to-left scripts) of the character defined by
HTMLTableRowElement.ch. This property was optional and was not very well supported. HTMLTableRowElement.vAlign-
A string representing an enumerated value indicating how the content of the cell must be vertically aligned. It reflects the
valignattribute and can have one of the following values:"top","middle","bottom", or"baseline".
Specifications
| Specification |
|---|
| HTML # htmltablerowelement |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
HTMLTableRowElement
|
|
|
|
|
|
|
|
|
|
|
|
|
align
|
|
|
|
|
|
|
|
|
|
|
|
|
bgColor
|
|
|
|
|
|
|
|
|
|
|
|
|
cells
|
|
|
|
|
|
|
|
|
|
|
|
|
ch
|
|
|
|
|
|
|
|
|
|
|
|
|
chOff
|
|
|
|
|
|
|
|
|
|
|
|
|
deleteCell
|
|
|
|
|
|
|
|
|
|
|
|
|
insertCell
|
|
|
|
|
|
|
|
|
|
|
|
|
index parameter can be -1
|
|
|
|
|
|
|
|
|
|
|
|
|
index parameter is optional
|
|
|
|
|
|
|
|
|
|
|
|
|
rowIndex
|
|
|
|
|
|
|
|
|
|
|
|
|
sectionRowIndex
|
|
|
|
|
|
|
|
|
|
|
|
|
vAlign
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Deprecated. Not for use in new websites.
See also
- The HTML element implementing this interface:
<tr>.