Home | Top | Free Ajax Editor | JavaScript Editor | Get Advanced JavaScript and Ajax Editor, Validator and Debugger! 1st JavaScript Editor. |
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 |
Home | Top | Free Ajax Editor | JavaScript Editor | Get Advanced JavaScript and Ajax Editor, Validator and Debugger! 1st JavaScript Editor. |