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 defilho
.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>
js
// 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);
js
// Removendo um elemento específico sem precisar especificar seu pai
var no = document.getElementById("interno");
if (no.parentNode) {
no.parentNode.removeChild(no);
}
js
// Removendo todos os nós filhos de um elemento
var elemento = document.getElementById("topo");
while (elemento.firstChild) {
elemento.removeChild(elemento.firstChild);
}