HTMLTableRowElement
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.cells
Read only-
Returns a live
HTMLCollection
containing the cells in the row. TheHTMLCollection
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
.
Instance methods
Inherits methods from its parent, HTMLElement
.
deleteCell(index)
-
Removes the cell corresponding to
index
. Ifindex
is-1
, the last cell of the row is removed. Ifindex
is less than-1
or greater than the amount of cells in the collection, aDOMException
with the valueIndexSizeError
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 givenindex
position in the row. Ifindex
is-1
, the new cell is appended to the collection. Ifindex
is less than-1
or greater than the number of cells in the collection, aDOMException
with the valueIndexSizeError
is 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
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"
.
Specifications
Specification |
---|
HTML Standard # htmltablerowelement |
Browser compatibility
BCD tables only load in the browser
See also
- The HTML element implementing this interface:
<tr>
.