Home | Top | Free Ajax Editor | JavaScript Editor JavaScript EditorGet Advanced
JavaScript and Ajax Editor,
Validator and Debugger!

1st JavaScript Editor.


insertRow Method

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

[ Object Name ] Platform Version
Win16:
Win32:
Windows CE:
Unix:
Mac:
 
TABLE , TBODY , TFOOT , THEAD
Home | Top | Free Ajax Editor | JavaScript Editor JavaScript EditorGet Advanced
JavaScript and Ajax Editor,
Validator and Debugger!

1st JavaScript Editor.