nginstack

Class: Node

@nginstack/engine/lib/dom/Node~ Node

new Node()

Node é 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.

Todos os tipos a seguir herdam essa interface e seus métodos e propriedades (apesar de que alguns podem devolver null 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): Document, Element, Attr, CharacterData (do qual Text, Comment, e CDATASection herdam), ProcessingInstruction, DocumentFragment, DocumentType, Notation, Entity, EntityReference.

Documentação adaptada de Node dos Mozilla Contributors e licenciada sob CC-BY-SA 2.5.

Members

<readonly> childNodes :NodeList

Retorna um objeto NodeList "vivo" contendo todos os filhos deste nó. Dizer que um objeto NodeList é vivo significa que se houver alguma mudança em um dos filhos deste nó, o objeto NodeList é automaticamente atualizado com tais mudanças.

Type:
  • NodeList

<readonly> firstChild :Node

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

Type:
  • Node

<readonly> lastChild :Node

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

Type:
  • Node

<readonly> namespaceURI :string

O espaço de nomes URI desse nó, ou null se não estiver no espaço de nomes.

Type:
  • string
Deprecated:
  • Yes

<readonly> nextSibling :Node

Retorna um Node representando o próximo nó em uma árvore ou null se não existe tal nodo.

Type:
  • Node

<readonly> nodeName :string

Retorna uma DOMString contendo o nome do elemento, do Node. A estrutura do nome irá mudar conforme o tipo do elemento. Veja as diferenças na documentação do método Node.nodeName.

Type:
  • string

<readonly> nodeType :NodeType|''

Retorna um número inteiro representando o tipo do nó. Os valores possíveis são:

  • ELEMENT_NODE: 1
  • ATTRIBUTE_NODE: 2
  • TEXT_NODE: 3
  • CDATA_SECTION_NODE: 4
  • ENTITY_REFERENCE_NODE: 5
  • ENTITY_NODE: 6
  • PROCESSING_INSTRUCTION_NODE: 7
  • COMMENT_NODE: 8
  • DOCUMENT_NODE: 9
  • DOCUMENT_TYPE_NODE: 10
  • DOCUMENT_FRAGMENT_NODE: 11
  • NOTATION_NODE: 12
Type:
  • NodeType | ''

<readonly> nodeValue :string

Retorna ou define o valor do nó atual.

Type:
  • string

<readonly> ownerDocument :Document

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

Type:
  • Document

<readonly> parentNode :Node

Retorna um 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 null.

Type:
  • Node

<readonly> prefix :string

É um DOMString representando o espaço de nomes do nó, ou null se nenhum prefixo é especificado.

Type:
  • string

<readonly> previousSibling :Node

Retorna um Node representando o nó anterior em uma árvore ou null se não existe tal nodo.

Type:
  • Node

Methods

appendChild(newChild)

Adiciona um nó ao final da lista de filhos de um nó pai especificado.

Se filho é uma referência a um nó existente no documento, appendChild vai movê-lo de sua posição atual para a nova posição (i.e, não é necessário remover o nó de seu pai atual antes de adicioná-lo a outro nó).

Isso também significa que um nó não pode estar em dois lugares do documento ao mesmo tempo. Assim, se o nó já tem um pai, ele é primeiro removido para, só então, ser adicionado na nova posição.

Você pode usar o método #cloneNode para criar uma cópia do nó antes de adicioná-lo ao novo pai. Note que cópias feitas com o método cloneNode não serão mantidas sincronizadas automaticamente.

Parameters:
Name Type Description
newChild Node

É o nó a ser adicionado como filho de elemento.
Returns:

Nó adicionado no DOM, o mesmo que foi informado em newChild.

Type
Node

cloneNode(deep)

Duplica um elemento node (nó) da estrutura de um documento DOM. Ele retorna um clone do elemento para o qual foi invocado.

Parameters:
Name Type Description
deep boolean

Indica se os elementos filhos do nó que está sendo clonado devem ser clonados juntos. Informe false para clonar apenas o nó específico dispensando, assim, qualquer elemento DOM filho.
Returns:

O novo elemento node (nó) resultado da clonagem.

Type
Node

hasChildNodes()

Este método retorna um valor booleano indicando se o nó corrente tem filhos ou não.

Returns:

True se o nó tiver filhos.

Type
boolean

insertBefore(newChild, refChild)

Adiciona o nó especificado, antes de um elemento de referência, como filho do nó atual.

Parameters:
Name Type Description
newChild Node

O nó a ser inserido.
refChild Node

O nó antes do qual o newChild será inserido.
Returns:

O nó sendo inserido, que é newChild.

Type
Node

normalize()

Coloca o nó e todos os nós filhos nas suas formas normalizadas. Em uma subárvore normalizada não há nós do tipo Text vazios, nem há nós adjacentes desse mesmo tipo.

removeChild(oldChild)

Remove um nó filho do DOM. Devolve o nó removido.

Parameters:
Name Type Description
oldChild Node

É o nó filho a ser removido do DOM.
Returns:

Contém uma referência ao nó filho removido.

Type
Node

replaceChild(newChild, oldChild)

Substitui o elemento filho especificado por outro.

Parameters:
Name Type Description
newChild Node

É o novo elemento que será inserido no lugar do oldChild. Se já existir no DOM, será removido primeiro para depois ser inserido.
oldChild Node

É o elemento existente que será substituído.
Returns:

É o elemento substituído. É o mesmo elemento que oldChild.

Type
Node