--- title: element.appendChild slug: Web/API/Node/appendChild tags: - Referência_do_DOM_Gecko translation_of: Web/API/Node/appendChild original_slug: DOM/element.appendChild ---
{{ ApiRef() }}
Adiciona um novo nó (filho) a um determinado elemento (objeto)
element.appendChild(child)
element
é o elemento pai.child
é o nó que será adicionado como filho de element
.// Cria um novo Elemento(Objeto) var p = document.createElement("p"); // Adiciona ao Elemento Body (este deverá existir!) document.body.appendChild(p);
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.
{{ languages( { "en": "en/DOM/element.appendChild", "fr": "fr/DOM/element.appendChild", "pl": "pl/DOM/element.appendChild" } ) }}