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.

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.

EventTarget Node Element HTMLElement HTMLTableRowElement

Instance properties

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 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.sectionRowIndex Read 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. 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.

HTMLTableRowElement.insertCell()

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.

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 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 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 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
# htmltablerowelement

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
HTMLTableRowElement
align
Deprecated
bgColor
Deprecated
cells
ch
Deprecated
chOff
Deprecated
deleteCell
insertCell
index parameter can be -1
index parameter is optional
rowIndex
sectionRowIndex
vAlign
Deprecated

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>.