Node.childNodes

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨julho de 2015⁩.

A propriedade somente leitura Node.childNodes retorna uma coleção viva de nós filhos de um dado elemento.

Sintaxe

var listaNos = noReferencia.childNodes;

listaNos é uma coleção ordenada de objetos node que são filhos do elemento corrente. Se o elemento não tem filhos, então listaNos não contém nenhum nó.

A listaNos é uma variável que armazena a lista de nós de childNodes. O tipo dessa lista é NodeList.

Exemplo

// parg é uma referência de objeto a um elemento <p> if (parg.hasChildNodes()) { // Primeiramente verificamos se o objeto não está vazio, se o objeto tem nós filhos var filhos = parg.childNodes; for (var i = 0; i < filhos.length; i++) { // fazer algo com cada filho em filhos[i] // NOTE: A lista é viva - adicionar ou remover filhos altera a lista } }

// Esta é uma forma para remover todos os filhos de um nó // box é uma referência de objeto para um elemento com filhos while (box.firstChild) { // A lista é VIVA, então ela re-indexará a cada chamada box.removeChild(box.firstChild); }

Os itens na coleção de nós são objetos, não strings. Para recuperar dados dos objetos dos nós, você deve usar suas propriedades (e.g., noReferencia.childNodes[1].nodeName para recuperar o nome, etc.).

O objeto document tem 2 filhos: a declaração Doctype declaration e o elemento raiz, tipicamente referido como documentElement. (Em documentos (X)HTML este é o elemento HTML)