Node

Propriedades

Herda propriedades de seus pais, EventTarget.[1]

Node.baseURI Somente leitura

Retorna uma String 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 domnio e a estrutura de diretrio; tudo isso at a ltima '/'.

Node.baseURIObject

Retorna um objeto nsIURI, representando o URL base do n. (Indisponvel para contedo Web)

Node.childNodes Somente leitura

Retorna um objeto NodeList "vivo" contendo todos os filhos deste n. Dizer que um objeto NodeList vivo significa que se houver alguma mudana em um dos filhos deste n, o objeto NodeList automaticamente atualizado com tais mudanas.

Node.firstChild Somente leitura

Retorna um Node representando o primeiro filho direto do n ou null, caso o n no tenha nenhum filho.

Node.lastChild Somente leitura

Retorna um Node representando o ltimo filho direto do elemento ou null, caso o elemento no tenha nenhum filho.

Node.nextSibling Somente leitura

Retorna um Node representando o prximo elemento na rvore ou null, caso tal n no exista.

Node.nodeName Somente leitura

Retorna uma String contendo o nome do elemento, do Node. A estrutura do nome ir mudar conforme o tipo do elemento. Veja as diferenas na documentao do mtodo Node.nodeName.

Node.nodePrincipal

Uma interface nsIPrincipal representando o n principal.

Node.nodeTypeSomente leitura

Retorna um unsigned short representando o tipo do nodo. Valores possveis so:

Node.nodeValue

Retorna / Define o valor do n atual

Node.ownerDocument Somente leitura

Retorna o Document qual esse n pertence. Se o n em si um documento, retorna null.

Node.parentNode Somente leitura

Retorna um Node que pai desse n. Se no existe tal n, como, por exemplo, se esse n o topo da rvore ou se ele no participa de uma rvore, essa propriedade retorna null.

Node.previousSibling Somente leitura

Retorna um Node representando o ltimo n em uma rvore ou null se no existe tal nodo.

Node.textContent

Retorna / Define o contedo textual de um elemento e de todos os seus descendentes.

Propriedades descontinuadas

Node.rootNode Somente leitura

Retorna um objeto Node representando o n mais alto em uma rvore, ou o n atual, se ele for o mais alto da rvore. Isso foi substitudo por Node.getRootNode().

Propriedades obsoletas

Node.localNameSomente leitura

Retorna um String representando a parte local do nome qualificado de um elemento.

Nota: No Firefox 3.5 e nas verses anteriores, a propriedade coloca em caixa alta o nome local de elementos HTML (mas no elementos XHTML). Em verses posteriores, isso no acontece, ento a propriedade est em caixa baixa para ambos HTML e XHTML.

Node.namespaceURISomente leitura

O espao de nomes URI desse n, ou null se no estiver no espao de nomes.

Nota: No Firefox 3.5 e nas verses anteriores, elementos HTML esto no espao de nomes. Em verses posteriores, elementos HTML esto em https://www.w3.org/1999/xhtml/, nas rvores HTML e XML.

Node.prefixSomente leitura

um String representando o espao de nomes do n, ou null se nenhum prefixo especificado.

Mtodos

• Node.appendChild
• Node.cloneNode
• Node.compareDocumentPosition
• Node.contains
• Node.getFeature
• Node.getUserData
• Node.hasAttributes
• Node.hasChildNodes
• Node.insertBefore
• Node.isDefaultNamespace
• Node.isEqualNode
• Node.isSameNode
• Node.lookupPrefix
• Node.lookupNamespaceURI
• Node.normalize
• Node.removeChild
• Node.replaceChild
• Node.setUserData

Constantes

Veja tambm Node.nodeType

Exemplos de cdigo

Recuperar todos os ns filhos

A funo a seguir percorre todos os ns filhos de um n recursivamente e executa uma funo de callback em cada um deles (e no n pai tambm).

function DOMComb(oParent, oCallback) {
  if (oParent.hasChildNodes()) {
    for (var oNode = oParent.firstChild; oNode; oNode = oNode.nextSibling) {
      DOMComb(oNode, oCallback);
    }
  }
  oCallback.call(oParent);
}

Sintaxe

DOMComb(parentNode, callbackFunction);

Descrio

Percorre todos os ns filhos de parentNode recursivamente e o prprio parentNode e executa a callbackFunction em cada um deles como this.

Parmetros

parentNode

O n pai (Objectdo tipo Node).

callbackFunction

A funo de callback (Function).

Exemplo de uso

O exemplo a seguir envia para a funo console.log o contedo textual do body:

function imprimeConteudo() {
  if (this.nodeValue) {
    console.log(this.nodeValue);
  }
}

onload = function () {
  DOMComb(document.body, imprimeConteudo);
};

Especificaes

Compatibilidade com navegadores