aboutsummaryrefslogtreecommitdiff
path: root/files/pt-br/web/api/node/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'files/pt-br/web/api/node/index.html')
-rw-r--r--files/pt-br/web/api/node/index.html303
1 files changed, 303 insertions, 0 deletions
diff --git a/files/pt-br/web/api/node/index.html b/files/pt-br/web/api/node/index.html
new file mode 100644
index 0000000000..8b265cdbd5
--- /dev/null
+++ b/files/pt-br/web/api/node/index.html
@@ -0,0 +1,303 @@
+---
+title: Node
+slug: Web/API/Node
+translation_of: Web/API/Node
+---
+<div>{{Apiref("DOM")}}</div>
+
+<p><strong><code>Node</code></strong> é uma interface da qual diversos tipos do DOM herdam, e que permite que esses tipos sejam tratados de forma similar, por exemplo, herdando os mesmos métodos ou sendo testados da mesma forma.<br>
+ <br>
+ Todos os tipos a seguir herdam essa interface e seus métodos e propriedades (apesar de que alguns podem devolver <code>null</code> em casos particulares em que o método ou a propriedade não são relevantes; ou lançar uma exceção quando adicionando um filho a um tipo de nó que não pode ter filhos): {{domxref("Document")}}, {{domxref("Element")}}, {{domxref("Attr")}}, {{domxref("CharacterData")}} (do qual {{domxref("Text")}}, {{domxref("Comment")}}, e {{domxref("CDATASection")}} herdam), {{domxref("ProcessingInstruction")}}, {{domxref("DocumentFragment")}}, {{domxref("DocumentType")}}, {{domxref("Notation")}}, {{domxref("Entity")}}, {{domxref("EntityReference")}}</p>
+
+<p>{{InheritanceDiagram}}</p>
+
+<p> </p>
+
+<h2 id="Propriedades">Propriedades</h2>
+
+<p><em>Herda propriedades de seus pais, {{domxref("EventTarget")}}</em>.<sup>[1]</sup></p>
+
+<dl>
+ <dt>{{domxref("Node.baseURI")}} {{readonlyInline}}</dt>
+ <dd>Retorna uma {{domxref("DOMString")}} representando o URL base do nó. O conceito de URL base muda de uma linguagem para outra; no HTML, ela corresponde ao protocolo, ao nome de domínio e a estrutura de diretório; tudo isso até a última <code>'/'</code>.</dd>
+ <dt>{{domxref("Node.baseURIObject")}} {{Non-standard_inline()}} {{ Fx_minversion_inline("3") }}</dt>
+ <dd>Retorna um objeto {{ Interface("nsIURI") }}, representando o URL base do nó. <em>(Indisponível para conteúdo Web)</em></dd>
+ <dt>{{domxref("Node.childNodes")}} {{readonlyInline}}</dt>
+ <dd>Retorna um objeto {{domxref("NodeList")}} "vivo" contendo todos os filhos deste nó. Dizer que um objeto {{domxref("NodeList")}} é vivo significa que se houver alguma mudança em um dos filhos deste nó, o objeto {{domxref("NodeList")}} é automaticamente atualizado com tais mudanças.</dd>
+ <dt>{{domxref("Node.firstChild")}} {{readonlyInline}}</dt>
+ <dd>Retorna um {{domxref("Node")}} representando o primeiro filho direto do nó ou <code>null</code>, caso o nó não tenha nenhum filho.</dd>
+ <dt>{{domxref("Node.lastChild")}} {{readonlyInline}}</dt>
+ <dd>Retorna um {{domxref("Node")}} representando o último filho direto do elemento ou <code>null</code>, caso o elemento não tenha nenhum filho.</dd>
+ <dt>{{domxref("Node.nextSibling")}} {{readonlyInline}}</dt>
+ <dd>Retorna um {{domxref("Node")}} representando o próximo elemento na árvore ou <code>null</code>, caso tal nó não exista.</dd>
+ <dt>{{domxref("Node.nodeName")}} {{readonlyInline}}</dt>
+ <dd>Retorna uma {{domxref("DOMString")}} contendo o nome do elemento, do <code>Node</code>. A estrutura do nome irá mudar conforme o tipo do elemento. Veja as diferenças na documentação do método {{domxref("Node.nodeName")}}.  </dd>
+ <dt>{{domxref("Node.nodePrincipal")}} {{Non-standard_inline()}}{{ Fx_minversion_inline("3") }}</dt>
+ <dd>Uma interface {{ Interface("nsIPrincipal") }} representando o nó principal.</dd>
+ <dt>{{domxref("Node.nodeType")}}{{readonlyInline}}</dt>
+ <dd>Retorna um <code>unsigned short</code> representando o tipo do nodo. Valores possíveis são:</dd>
+</dl>
+
+<table class="standard-table">
+ <thead>
+ <tr>
+ <th scope="col">Nome</th>
+ <th scope="col">Valor</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code>ELEMENT_NODE</code></td>
+ <td>1</td>
+ </tr>
+ <tr>
+ <td><code>ATTRIBUTE_NODE</code></td>
+ <td>2</td>
+ </tr>
+ <tr>
+ <td><code>TEXT_NODE</code></td>
+ <td>3</td>
+ </tr>
+ <tr>
+ <td><code>CDATA_SECTION_NODE</code></td>
+ <td>4</td>
+ </tr>
+ <tr>
+ <td><code>ENTITY_REFERENCE_NODE</code></td>
+ <td>5</td>
+ </tr>
+ <tr>
+ <td><code>ENTITY_NODE</code></td>
+ <td>6</td>
+ </tr>
+ <tr>
+ <td><code>PROCESSING_INSTRUCTION_NODE</code></td>
+ <td>7</td>
+ </tr>
+ <tr>
+ <td><code>COMMENT_NODE</code></td>
+ <td>8</td>
+ </tr>
+ <tr>
+ <td><code>DOCUMENT_NODE</code></td>
+ <td>9</td>
+ </tr>
+ <tr>
+ <td><code>DOCUMENT_TYPE_NODE</code></td>
+ <td>10</td>
+ </tr>
+ <tr>
+ <td><code>DOCUMENT_FRAGMENT_NODE</code></td>
+ <td>11</td>
+ </tr>
+ <tr>
+ <td><code>NOTATION_NODE</code></td>
+ <td>12</td>
+ </tr>
+ </tbody>
+</table>
+
+<dl>
+ <dt>{{domxref("Node.nodeValue")}}</dt>
+ <dd>Retorna / Define o valor do nó atual</dd>
+ <dt>{{domxref("Node.ownerDocument")}} {{readonlyInline}}</dt>
+ <dd>Retorna o {{domxref("Document")}} qual esse nó pertence. Se o nó em si é um documento, retorna <code>null</code>.</dd>
+ <dt>{{domxref("Node.parentNode")}} {{readonlyInline}}</dt>
+ <dd>Retorna um {{domxref("Node")}} que é pai desse nó. Se não existe tal nó, como, por exemplo, se esse nó é o topo da árvore ou se ele não participa de uma árvore, essa propriedade retorna <code>null</code>.</dd>
+ <dt>{{domxref("Node.previousSibling")}} {{readonlyInline}}</dt>
+ <dd>Retorna um {{domxref("Node")}} representando o último nó em uma árvore ou <code>null</code> se não existe tal nodo.</dd>
+ <dt>{{domxref("Node.textContent")}}</dt>
+ <dd>Retorna / Define o conteúdo textual de um elemento e de todos os seus descendentes.<br>
+ <br>
+  </dd>
+</dl>
+
+<h3 id="Propriedades_descontinuadas">Propriedades descontinuadas</h3>
+
+<dl>
+ <dt>{{domxref("Node.rootNode")}} {{readOnlyInline}} {{deprecated_inline}}</dt>
+ <dd>Retorna um objeto {{domxref("Node")}} representando o nó mais alto em uma árvore, ou o nó atual, se ele for o mais alto da árvore. Isso foi substituído por {{domxref("Node.getRootNode()")}}.</dd>
+ <dt>
+ <h3 id="Propriedades_obsoletas">Propriedades obsoletas</h3>
+ </dt>
+ <dt>{{domxref("Node.localName")}} {{obsolete_inline}}{{readonlyInline}}</dt>
+ <dd>Retorna um {{domxref("DOMString")}} representando a parte local do nome qualificado de um elemento.
+ <div class="note">
+ <p><strong>Nota:</strong> No Firefox 3.5 e nas versões anteriores, a propriedade coloca em caixa alta o nome local de elementos HTML (mas não elementos XHTML). Em versões posteriores, isso não acontece, então a propriedade está em caixa baixa para ambos HTML e XHTML. {{gecko_minversion_inline("1.9.2")}}</p>
+ </div>
+ </dd>
+ <dt>{{domxref("Node.namespaceURI")}} {{obsolete_inline}}{{readonlyInline}}</dt>
+ <dd>O espaço de nomes URI desse nó, ou <code>null</code> se não estiver no espaço de nomes.
+ <div class="note">
+ <p><strong>Nota:</strong> No Firefox 3.5 e nas versões anteriores, elementos HTML estão no espaço de nomes. Em versões posteriores, elementos HTML estão em <code><a class="linkification-ext external" href="https://www.w3.org/1999/xhtml/" style="outline: 1px dotted; outline-offset: 0px;" title="Linkification: http://www.w3.org/1999/xhtml">http://www.w3.org/1999/xhtml/</a></code>, nas árvores HTML e XML. {{gecko_minversion_inline("1.9.2")}}</p>
+ </div>
+ </dd>
+ <dt>{{domxref("Node.prefix")}} {{obsolete_inline}}{{readonlyInline}}</dt>
+ <dd>É um {{domxref("DOMString")}} representando o espaço de nomes do nó, ou <code>null</code> se nenhum prefixo é especificado.</dd>
+</dl>
+
+<h2 id="Métodos">Métodos</h2>
+
+<p> </p>
+
+<ul>
+ <li>{{domxref("Node.appendChild")}}</li>
+ <li>{{domxref("Node.cloneNode")}}</li>
+ <li>{{domxref("Node.compareDocumentPosition")}}</li>
+ <li>{{domxref("Node.contains")}}</li>
+ <li>{{domxref("Node.getFeature")}} {{obsolete_inline("7.0")}}</li>
+ <li>{{domxref("Node.getUserData")}} {{obsolete_inline("22.0")}}</li>
+ <li>{{domxref("Node.hasAttributes")}} {{obsolete_inline("22.0")}}</li>
+ <li>{{domxref("Node.hasChildNodes")}}</li>
+ <li>{{domxref("Node.insertBefore")}}</li>
+ <li>{{domxref("Node.isDefaultNamespace")}}</li>
+ <li>{{domxref("Node.isEqualNode")}}</li>
+ <li>{{domxref("Node.isSameNode")}} {{deprecated_inline("9.0")}} {{obsolete_inline("10.0")}}</li>
+ <li>{{domxref("Node.isSupported")}} {{obsolete_inline("22.0")}}</li>
+ <li>{{domxref("Node.lookupPrefix")}}</li>
+ <li>{{domxref("Node.lookupNamespaceURI")}}</li>
+ <li>{{domxref("Node.normalize")}}</li>
+ <li>{{domxref("Node.removeChild")}}</li>
+ <li>{{domxref("Node.replaceChild")}}</li>
+ <li>{{domxref("Node.setUserData")}} {{obsolete_inline("22.0")}}</li>
+</ul>
+
+<p> </p>
+
+<h2 id="Constantes">Constantes</h2>
+
+<p>Veja também {{domxref("Node.nodeType")}}</p>
+
+<table class="standard-table">
+ <tbody>
+ <tr>
+ <th>Nome</th>
+ <th>Valor</th>
+ </tr>
+ <tr>
+ <td><code>ELEMENT_NODE</code></td>
+ <td>1</td>
+ </tr>
+ <tr>
+ <td><code>ATTRIBUTE_NODE</code></td>
+ <td>2</td>
+ </tr>
+ <tr>
+ <td><code>TEXT_NODE</code></td>
+ <td>3</td>
+ </tr>
+ <tr>
+ <td><code>DATA_SECTION_NODE</code></td>
+ <td>4</td>
+ </tr>
+ <tr>
+ <td><code>ENTITY_REFERENCE_NODE</code></td>
+ <td>5</td>
+ </tr>
+ <tr>
+ <td><code>ENTITY_NODE</code></td>
+ <td>6</td>
+ </tr>
+ <tr>
+ <td><code>PROCESSING_INSTRUCTION_NODE</code></td>
+ <td>7</td>
+ </tr>
+ <tr>
+ <td><code>COMMENT_NODE</code></td>
+ <td>8</td>
+ </tr>
+ <tr>
+ <td><code>DOCUMENT_NODE</code></td>
+ <td>9</td>
+ </tr>
+ <tr>
+ <td><code>DOCUMENT_TYPE_NODE</code></td>
+ <td>10</td>
+ </tr>
+ <tr>
+ <td><code>DOCUMENT_FRAGMENT_NODE</code></td>
+ <td>11</td>
+ </tr>
+ <tr>
+ <td><code>NOTATION_NODE</code></td>
+ <td>12</td>
+ </tr>
+ <tr>
+ <td><code>DOCUMENT_POSITION_DISCONNECTED</code></td>
+ <td>0x01</td>
+ </tr>
+ <tr>
+ <td><code>DOCUMENT_POSITION_PRECEDING</code></td>
+ <td>0x02</td>
+ </tr>
+ <tr>
+ <td><code>DOCUMENT_POSITION_FOLLOWING</code></td>
+ <td>0x04</td>
+ </tr>
+ <tr>
+ <td><code>DOCUMENT_POSITION_CONTAINS</code></td>
+ <td>0x08</td>
+ </tr>
+ <tr>
+ <td><code>DOCUMENT_POSITION_CONTAINED_BY</code></td>
+ <td>0x10</td>
+ </tr>
+ <tr>
+ <td><code>DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC</code></td>
+ <td>0x20</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="Exemplos_de_código">Exemplos de código</h2>
+
+<h3 id="Recuperar_todos_os_nós_filhos">Recuperar todos os nós filhos</h3>
+
+<p>A função a seguir percorre todos os nós filhos de um nó recursivamente e executa uma função de callback em cada um deles (e no nó pai também).</p>
+
+<pre class="brush: js">function DOMComb (oParent, oCallback) {
+  if (oParent.hasChildNodes()) {
+    for (var oNode = oParent.firstChild; oNode; oNode = oNode.nextSibling) {
+      DOMComb(oNode, oCallback);
+    }
+  }
+  oCallback.call(oParent);
+}</pre>
+
+<h4 id="Sintaxe">Sintaxe</h4>
+
+<pre>DOMComb(parentNode, callbackFunction);</pre>
+
+<h4 id="Descrição">Descrição</h4>
+
+<p>Percorre todos os nós filhos de <code>parentNode</code> recursivamente e o próprio <code>parentNode</code> e executa a <code>callbackFunction</code> em cada um deles como <a href="/en-US/docs/JavaScript/Reference/Operators/this" title="en-US/docs/JavaScript/Reference/Operators/this"><code>this</code></a>.</p>
+
+<h4 id="Parâmetros">Parâmetros</h4>
+
+<dl>
+ <dt><code>parentNode</code></dt>
+ <dd>O nó pai (<code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Object" title="en-US/docs/JavaScript/Reference/Global_Objects/Object">Object</a></code><code><strong> </strong>do tipo <strong>Node</strong></code>).</dd>
+ <dt><code>callbackFunction</code></dt>
+ <dd>A função de callback (<a href="/en-US/docs/JavaScript/Reference/Global_Objects/Function" title="en-US/docs/JavaScript/Reference/Global_Objects/Function"><code>Function</code></a>).</dd>
+</dl>
+
+<h4 id="Exemplo_de_uso">Exemplo de uso</h4>
+
+<p>O exemplo a seguir envia para a função <code>console.log</code> o conteúdo textual do body:</p>
+
+<pre class="brush: js">function imprimeConteudo () {
+  if (this.nodeValue) { console.log(this.nodeValue); }
+}
+
+onload = function () {
+  DOMComb(document.body, imprimeConteudo);
+};</pre>
+
+<h2 id="Especificações">Especificações</h2>
+
+<ul>
+ <li><a class="external" href="http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#ID-1950641247">DOM Level 1 Core: Node interface</a></li>
+ <li><a class="external" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-1950641247">DOM Level 2 Core: Node interface</a></li>
+ <li><a class="external" href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-1950641247">DOM Level 3 Core: Node interface</a></li>
+ <li><a href="http://dom.spec.whatwg.org/#interface-node" title="http://dom.spec.whatwg.org/#interface-node">DOM Standard: Node Interface</a></li>
+</ul>
generated by cgit v1.2.3-54-g00ecf (git 2.39.0) at 2025-01-20 23:32:01 +0000