Availability

DOM Level 1 HTML

Synopsis

HTMLElement insertRow(long index) 
    throws DOMException;

Arguments

index

The position at which the new row is to be inserted.

Returns

An HTMLTableRowElement that represents the newly inserted row.

Throws

This method throws a DOMException with a code of INDEX_SIZE_ERR if index is less than zero or greater than the number of rows in the table.

Description

This method creates a new HTMLTableRowElement representing a <tr> tag and inserts it into the table at the specified position.

The new row is inserted in the same section and immediately before the existing row at the position specified by index. If index is equal to the number of rows in the table, the new row is appended to the last section of the table. If the table is initially empty, the new row is inserted into a new <tbody> section that is itself inserted into the table.

You can use the convenience method HTMLTableRowElement.insertCell( ) to add content to the newly created row.

See Also

HTMLTableSectionElement.insertRow( )