coleção de células da tabela

Objeto Table do HTML DOM

definição e uso

cells a coleção retorna a coleção de todos os elementos <td> ou <th> da tabela.

Comentário:Os elementos no conjunto são ordenados na ordem em que aparecem no código-fonte.

Dica:usar coleção rows retorna a coleção de todos os elementos <tr> da tabela.

Dica:Use método insertRow() criar nova linha (<tr>).

Dica:Use método deleteRow() excluir linha.

Dica:Use método insertCell() Criar nova célula (<td>).

Dica:Use Método deleteCell() Remover célula.

Veja também:

Manual de Referência HTML:Etiqueta <td> do HTML

Manual de Referência HTML:Etiqueta <th> do HTML

Manual de Referência JavaScript:Objeto TableData do HTML DOM

Manual de Referência JavaScript:Objeto TableHeader do HTML DOM

Exemplo

Exemplo 1

Exibir o número de células na primeira linha:

var x = document.getElementById("myTable").rows[0].cells.length;

Experimente você mesmo

O resultado de x será:

2

Exemplo 2: [index]

Exibir o innerHTML da primeira célula na primeira linha da tabela:

alert(document.getElementById("myTable").rows[0].cells[0].innerHTML);

Experimente você mesmo

Exemplo 3: item(index)

Exibir o innerHTML da primeira célula na primeira linha da tabela:

alert(document.getElementById("myTable").rows[0].cells.item(0).innerHTML);

Experimente você mesmo

Exemplo 4: namedItem(id)

Exibir o innerHTML da célula com id="myTd" na primeira linha da tabela:

alert(document.getElementById("myTable").rows[0].cells.namedItem("myTd").innerHTML);

Experimente você mesmo

Exemplo 5

Alterar o conteúdo da primeira célula da tabela:

var x = document.getElementById("myTable").rows[0].cells;
x[0].innerHTML = "NOVO CONTEÚDO";

Experimente você mesmo

Sintaxe

tableObject.cells

Atributo

Atributo Descrição
length

Retorna o número de elementos <td> e/ou <th> no conjunto.

Comentário:Este atributo é apenas de leitura.

Método

Método Descrição
[index]

Retorna o elemento <td> e/ou <th> com o índice especificado no conjunto (começando com 0).

Comentário:Se o número do índice estiver fora do intervalo, retorna null.
item(index)

Retorna o elemento <td> e/ou <th> com o índice especificado no conjunto (começando com 0).

Comentário:Se o número do índice estiver fora do intervalo, retorna null.
namedItem(id)

Retorna os elementos <td> e/ou <th> de um conjunto que possui o id especificado.

Comentário:Se o id não existir, retorna null.

Detalhes Técnicos

Versão DOM: Documento de Nível 2 do Nível Core
Retorno:

O objeto HTMLCollection representa todos os elementos <td> e/ou <th> dentro do elemento <tr>.

Os elementos no conjunto são ordenados na ordem em que aparecem no código-fonte.

Suporte do navegador

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
Suporte Suporte Suporte Suporte Suporte

Objeto Table do HTML DOM