element.appendChild

Sumario

Adiciona um novo nó (filho) a um determinado elemento (objeto)

Sintaxe

element.appendChild(child)

• element é o elemento pai.
• child é o nó que será adicionado como filho de element.

Exemplo

// Cria um novo Elemento(Objeto)
var p = document.createElement("p");

// Adiciona ao Elemento Body (este deverá existir!) 
document.body.appendChild(p);

Notas

Se child é a referência para um nó ja existente no documento, appendChild moverá este para a nova posição (ou seja não é necessário remover um nó de uma posição para depois adicionar em outra). Isto significa que um nó não pode estar em dois lugares do documento ao mesmo tempo.

Você pode usar também cloneNode para copiar este nó e depois adicioná-lo a outro elemento. (Observe que ao criar um objeto ultilizando cloneNode ou createElement este não fará parte do documento até você torna-lo parte deste usando appendChild ou método similar)

Métodos relacionados : insertBefore, replaceChild and removeChild. <code>appendChild</code> é um dos métodos essenciais na programação usando DOM. O método <code>appendChild</code> insere um novo nó na estrutura DOM e este é a segunda parte da metodologia create-and-append.

Especificação

DOM Level 2 Core: appendChild