Name
HTMLTableElement.insertRow( ) — add a new, empty row to the table
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.