Please note, this is a STATIC archive of website developer.mozilla.org from November 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

Node.removeChild

Sumário

Remove um nó filho do DOM. Devolve o nó removido.

Sintaxe

var filhoRemovido = elemento.removeChild(filho);
elemento.removeChild(filho);
  • filho é o nó filho a ser removido do DOM.
  • elemento é o nó pai de filho.
  • filhoRemovido contém uma referência ao nó filho removido. filhoRemovido === filho.

O nó filho removido ainda existe em memória, mas não é mais parte do DOM. Você pode reutilizar o nó removido mais tarde no seu código por meio da referência filhoRemovido.

Se filho não for um filho do nó elemento, o método lança uma exceção. Isto também acontecerá se filho era, de fato, um filho de elemento no momento da chamada, mas foi removido por um manipulador de eventos invocado enquanto o elemento estava sendo removido (por exemplo, blur).

Exemplos

<!--Código HTML de exemplo-->

<div id="topo" align="center">
  <div id="interno"></div>
</div>
// Removendo um elemento específico quando se conhece seu pai
var d = document.getElementById("topo");
var d_interno = document.getElementById("interno");
var noRemovido = d.removeChild(d_interno);
// Removendo um elemento específico sem precisar especificar seu pai
var no = document.getElementById("interno");
if (no.parentNode) {
  no.parentNode.removeChild(no);
}
// Removendo todos os nós filhos de um elemento
var elemento = document.getElementById("topo");
while (elemento.firstChild) {
  elemento.removeChild(elemento.firstChild);
}

Especificação

Veja também

Etiquetas do documento e colaboradores

 Colaboradores desta página: teoli, khalid32, srsaude
 Última atualização por: teoli,