Creates a new row (tr) in the table, and adds the row to the rows collection.
Syntax
oTR = object.insertRow( [iIndex])
Parameters
iIndex Optional. Integer that specifies where to insert the row in the rows collection. The default value is -1, which appends the new row to the end of the rows collection.
Return Value
Returns the tr element object if successful, or null otherwise.
null
Remarks
The preferred technique for inserting a row is to add the row at the end of the rows collection. It is faster to add a row at the end of a table than somewhere in the middle. To add a row at the end of the collection, specify the -1 value, or the length of the rows collection minus 1.
-1
1
Example
This example uses the insertRow method to add a row to the table. myNewRow = document.all.myTable.insertRow()
This example uses the insertRow method to add a row to the table.
myNewRow = document.all.myTable.insertRow()
Standards Information
This method is defined in World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 .
Applies To
TABLE, TBODY, TFOOT, THEAD, HTMLTableElement Constructor, HTMLTableSectionElement Constructor
See Also
rowIndex, rows, sectionRowIndex