insertRow
(method
)
Owning interface and usage:
HTMLTableElement.
insertRow(
index)
Member of these other interfaces:
none
Description:
Insert a new empty row in the table. The new row is inserted immediately before and in the same section as the current indexth row in the table. If index is -1 or equal to the number of rows, the new row is appended. In addition, when the table is empty the row is inserted into
a TBODY which is created and inserted into the table.
Parameters:
| long index |
- |
The row number where to insert a new row. This index starts from 0 and is relative to the logical order (not document order)
of all the rows contained inside the table.
|
Returns:
HTMLElement -
The newly created row.
Exceptions:
- DOMException INDEX_SIZE_ERR
-
Raised if the specified index is greater than the number of rows or if the index is a negative number other than -1.
Note:
A table row cannot be empty according to
[HTML40]
.