Web/API/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.

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25  236,20  236,30  226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25  351,20  351,30  341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25  501,20  501,30  491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableRowElement" target="_top"><rect x="301" y="65" width="190" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="396" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLTableRowElement</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

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.

Methods

Inherits methods from its parent, HTMLElement.

HTMLTableRowElement.deleteCell()

Removes the cell at the given position in the row. If the given position is greater (or equal as it starts at zero) than the amount of cells in the row, or is smaller than 0, it raises a DOMException with the IndexSizeError value.

HTMLTableRowElement.insertCell()

Inserts a new cell just before the given position in the row. If the given position is not given or is -1, it appends the cell to the row. If the given position is greater (or equal as it starts at zero) than the amount of cells in the row, or is smaller than -1, it raises a DOMException with the IndexSizeError value. Returns a reference to a HTMLTableCellElement.

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 '

Is a DOMString 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 '

Is a DOMString containing the background color of the cells. It reflects the obsolete bgcolor attribute.

HTMLTableRowElement.ch '

Is a DOMString 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 '

Is a DOMString containing a 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 '

Is a DOMString 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	Status	Comment
HTML Living StandardThe definition of 'HTMLTableRowElement' in that specification.	Living Standard
HTML5The definition of 'HTMLTableRowElement' in that specification.	Recommendation	The parameter of insertCell is now optional and default to -1.
Document Object Model (DOM) Level 2 HTML SpecificationThe definition of 'HTMLTableRowElement' in that specification.	Obsolete	The cells, rowIndex, and selectionRowIndex properties are now read-only. The methods insertCell and deleteCell can raise exceptions.
Document Object Model (DOM) Level 1 SpecificationThe definition of 'HTMLTableRowElement' in that specification.	Obsolete	Initial definition.

Browser compatibility

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
HTMLTableRowElement	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support ≤12.1	Safari Full support Yes	WebView Android Full support 1	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support ≤12.1	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
align Deprecated'Non-standard'	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support ≤12.1	Safari Full support Yes	WebView Android Full support 1	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support ≤12.1	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
bgColor Deprecated'Non-standard'	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support ≤12.1	Safari Full support Yes	WebView Android Full support 1	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support ≤12.1	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
cells	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support ≤12.1	Safari Full support Yes	WebView Android Full support 1	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support ≤12.1	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
ch Deprecated'	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support ≤12.1	Safari Full support Yes	WebView Android Full support 1	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support ≤12.1	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
chOff Deprecated'	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support ≤12.1	Safari Full support Yes	WebView Android Full support 1	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support ≤12.1	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
deleteCell	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support ≤12.1	Safari Full support Yes	WebView Android Full support 1	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support ≤12.1	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
insertCell	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support ≤12.1	Safari Full support Yes	WebView Android Full support 1	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support ≤12.1	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
rowIndex	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support ≤12.1	Safari Full support Yes	WebView Android Full support 1	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support ≤12.1	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
sectionRowIndex	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support ≤12.1	Safari Full support Yes	WebView Android Full support 1	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support ≤12.1	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
vAlign Deprecated'Non-standard'	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support ≤12.1	Safari Full support Yes	WebView Android Full support 1	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support ≤12.1	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0

Legend

Full support  

Full support

Non-standard. Expect poor cross-browser support.'

Non-standard. Expect poor cross-browser support.

Deprecated. Not for use in new websites.'

Deprecated. Not for use in new websites.

See also

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

HTMLTableRowElement by Mozilla Contributors is licensed under CC-BY-SA 2.5.