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.
See Also
Get JavaScript: The Definitive Guide, Fourth Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.