files/pt-br/web/api/node/removechild/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

---
title: Node.removeChild
slug: Web/API/Node/removeChild
translation_of: Web/API/Node/removeChild
---
<div>
<div>{{ApiRef("DOM")}}</div>
</div>

<h2 id="Summary" name="Summary">Sumário</h2>

<p>Remove um nó filho do DOM. Devolve o nó removido.</p>

<h2 id="Syntax" name="Syntax">Sintaxe</h2>

<pre class="syntaxbox"><em>var filhoRemovido</em> = <em>elemento</em>.removeChild(<em>filho</em>);
<em>elemento</em>.removeChild(<em>filho</em>);
</pre>

<ul>
 <li><code>filho</code> é o nó filho a ser removido do DOM.</li>
 <li><code>elemento</code> é o nó pai de <code>filho</code>.</li>
 <li><code>filhoRemovido</code> contém uma referência ao nó filho removido. <code>filhoRemovido</code> === <code>filho</code>.</li>
</ul>

<p>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 <code>filhoRemovido</code>.</p>

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

<h2 id="Example" name="Example">Exemplos</h2>

<pre>&lt;!--Código HTML de exemplo--&gt;

&lt;div id="topo" align="center"&gt;
  &lt;div id="interno"&gt;&lt;/div&gt;
&lt;/div&gt;
</pre>

<pre class="brush: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);
</pre>

<pre class="brush:js">// Removendo um elemento específico sem precisar especificar seu pai
var no = document.getElementById("interno");
if (no.parentNode) {
  no.parentNode.removeChild(no);
}
</pre>

<pre class="brush:js">// Removendo todos os nós filhos de um elemento
var elemento = document.getElementById("topo");
while (elemento.firstChild) {
  elemento.removeChild(elemento.firstChild);
}
</pre>

<h2 id="Specification" name="Specification">Especificação</h2>

<ul>
 <li><a href="http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-removeChild">DOM Level 1 Core: removeChild</a></li>
 <li><a href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-1734834066">DOM Level 2 Core: removeChild</a></li>
 <li><a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-1734834066">DOM Level 3 Core: removeChild</a></li>
</ul>

<h2 id="See_also" name="See_also">Veja também</h2>

<ul>
 <li>{{domxref("Node.replaceChild")}}</li>
 <li>{{domxref("Node.parentNode")}}</li>
</ul>