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.

EventTarget

Node

Element

HTMLElement

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

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 with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* The HTML element implementing this interface: `<tr>`.