diff options
Diffstat (limited to 'files/pt-br/web/api/node/removechild/index.html')
| -rw-r--r-- | files/pt-br/web/api/node/removechild/index.html | 72 |
1 files changed, 72 insertions, 0 deletions
diff --git a/files/pt-br/web/api/node/removechild/index.html b/files/pt-br/web/api/node/removechild/index.html new file mode 100644 index 0000000000..9eb927294d --- /dev/null +++ b/files/pt-br/web/api/node/removechild/index.html @@ -0,0 +1,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><!--Código HTML de exemplo--> + +<div id="topo" align="center"> + <div id="interno"></div> +</div> +</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> |