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.
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.
Inherits properties from its parent, HTMLElement
.
HTMLTableRowElement.cells
Read only
Returns a live HTMLCollection
containing the cells in the row. The HTMLCollection
is live and is automatically updated when cells are added or removed.
HTMLTableRowElement.rowIndex
Read only
Returns a long
value which gives the logical position of the row within the entire table. If the row is not part of a table, returns -1
.
HTMLTableRowElement.sectionRowIndex
Read only
Returns a long
value which 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
.
Inherits methods from its parent, HTMLElement
.
deleteCell(index)
Removes the cell corresponding to index
. If index
is -1
, the last cell of the row is removed. If index
is less than -1
or greater than the amount of cells in the collection, a DOMException
with the value IndexSizeError
is raised.
insertCell(index)
Returns an HTMLTableCellElement
representing a new cell of the row. The cell is inserted in the collection of cells immediately before the given index
position in the row. If index
is -1
, the new cell is appended to the collection. If index
is less than -1
or greater than the number of cells in the collection, a DOMException
with the value IndexSizeError
is raised.
Warning: These properties have been deprecated and should no longer be used. They are documented primarily to help understand older code bases.
HTMLTableRowElement.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"
.
HTMLTableRowElement.bgColor
Deprecated
A string containing the background color of the cells. It reflects the obsolete bgColor
attribute.
HTMLTableRowElement.ch
Deprecated
A string containing one single character. This character is the one to align all the cell of a column on. It reflects the char
and default 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
Deprecated
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
Deprecated
A string representing an enumerated value indicating how the content of the cell must be vertically aligned. It reflects the valign
attribute and can have one of the following values: "top"
, "middle"
, "bottom"
, or "baseline"
.
Specification |
---|
HTML Standard # htmltablerowelement |
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
HTMLTableRowElement |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
align |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
bgColor |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
cells |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
ch |
1 | 12 | 1 | 6 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
chOff |
1 | 12 | 1 | 6 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
deleteCell |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
insertCell |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
rowIndex |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
sectionRowIndex |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
vAlign |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
<tr>
.
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableRowElement