Creates a new cell in the table row (tr), and adds the cell to the cells collection.
 |
Syntax
var retval = tr.insertCell(index);Parameters
- index [in, optional]
-
Type: Integer
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
Type: Object
Returns the td element object if successful, or null otherwise.
Standards information
- Document Object Model (DOM) Level 2 HTML Specification, Section 1.6.5
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.
Examples
This example uses the insertCell method to add a cell to the end of the tr.
myNewCell = document.all.myTable.rows[0].insertCell()
See also
- tr
- Reference
- deleteCell
- insertRow
Build date: 11/28/2012
