insertRow Method | Internet Development Index |
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.
Remarks
If you insert a row in a tFoot, tBody, or tHead, you also need to add the row to the rows collection for the table. If you insert a row in the table, you also need to add the row to the rows collection for the tBody. If you specify an index, the index should be relative to the rows collection for the element that first contains the tr. For example, if you call this method for a tBody, you must specify an index value relative to the rows collection that is on the tBody, not the table.
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.
Example
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
See Also
rowIndex, rows, sectionRowIndex