TableRow cells Collection
Example
Show the number of cells in the first row:
var x = document.getElementById("myTable").rows[0].cells.length;
The result of x will be:
2
Try it Yourself »
More "Try it Yourself" examples below.
Definition and Usage
The cells collection returns a collection of all <td> or <th> elements in a table row.
Note: The elements in the collection are sorted as they appear in the source code.
Browser Support
| Collection | |||||
|---|---|---|---|---|---|
| cells | Yes | Yes | Yes | Yes | Yes |
Syntax
tableObject.cells
Properties
| Property | Description |
|---|---|
| length | Returns the number of <td> and/or <th> elements in the collection. Note: This property is read-only |
Methods
| Method | Description |
|---|---|
| [index] | Returns the <td> and/or <th> element from the collection with the specified index (starts at 0). Note: Returns null if the index number is out of range |
| item(index) | Returns the <td> and/or <th> element from the collection with the specified index (starts at 0). Note: Returns null if the index number is out of range |
| namedItem(id) | Returns the <td> and/or <th> element from the collection with the specified id. Note: Returns null if the id does not exist |
Technical Details
| DOM Version: | Core Level 2 Document Object |
|---|---|
| Return Value: | An HTMLCollection Object, representing all <td> and/or <th> elements in the <tr> element. The elements in the collection are sorted as they appear in the source code |
More Examples
Example
[index]
Alert the innerHTML of the first cell in the table's first row:
alert(document.getElementById("myTable").rows[0].cells[0].innerHTML);
Try it Yourself »
Example
item(index)
Alert the innerHTML of the first cell in the table's first row:
alert(document.getElementById("myTable").rows[0].cells.item(0).innerHTML);
Try it Yourself »
Example
namedItem(id)
Alert the innerHTML of the cell with id="myTd" in the table's first row:
alert(document.getElementById("myTable").rows[0].cells.namedItem("myTd").innerHTML);
Try it Yourself »
Example
Change the content of the first table cell:
var x = document.getElementById("myTable").rows[0].cells;
x[0].innerHTML = "NEW CONTENT";
Try it Yourself »
❮ TableRow Object
