insertCell Method

Creates a new cell in the table row ( tr ), and adds the cell to the cells collection.

Syntax

oTD = TR .insertCell( [ iIndex ] )

Parameters

iIndex

Optional. Integer that specifies where to insert the cell in the tr . The default value is -1 , which appends the new cell to the end of the cells collection.

Return Value

Returns the td element object if successful, or null otherwise.

Remarks

The preferred technique for inserting a cell is to add the cell at the end of the cells collection. It is faster to add a cell at the end of a row than somewhere in the middle. To add a cell at the end of the collection, specify the -1 value, or the length of the cells collection minus 1 .

Example

This example uses the insertCell method to add a cell to the end of the tr .