TheHTMLTableRowElement interface provides special properties and methods (beyond theHTMLElement 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 liveHTMLCollection containing the cells in the row. TheHTMLCollection is 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 toindex. 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.

HTMLTableRowElement.insertCell()

Returns anHTMLTableCellElement 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

HTMLTableRowElement.alignDeprecated

A string containing an enumerated value reflecting thealign attribute. It indicates the alignment of the element's contents to the surrounding context. The possible values are"left","right", and"center".

HTMLTableRowElement.bgColorDeprecated

A string containing the background color of the cells. It reflects the obsoletebgColor attribute.

HTMLTableRowElement.chDeprecated

A string containing one single character. This character is the one to align all the cell of a column on. It reflects thechar 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.chOffDeprecated

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 byHTMLTableRowElement.ch. This property was optional and was not very well supported.

HTMLTableRowElement.vAlignDeprecated

A string representing an enumerated value indicating how the content of the cell must be vertically aligned. It reflects thevalign attribute and can have one of the following values:"top","middle","bottom", or"baseline".

Specifications

Browser compatibility

See also

• The HTML element implementing this interface:<tr>.