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

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, HTMLTableElement Constructor, HTMLTableSectionElement Constructor

See Also

rowIndex, rows, sectionRowIndex