Class: Element

@nginstack/engine/lib/dom/Element~ Element


new Element()

Element é a classe base mais geral da qual todos os objetos em um Document herdam. Ela somente tem métodos e propriedades comuns para todos os tipos de elementos. Classes específicas herdam de Element. Por exemplo, a interface HTMLElement é a interface base para elementos HTML, enquanto a interface SVGElement é a base para todos os elementos SVG. A maioria das funcionalidades é especificada mais abaixo da hierarquia de classes.

A classe Element herda as propriedades e métodos de module:@nginstack/engine/lib/dom/Node~Node.

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

Deprecated:
  • Esta funcionalidade é obsoleta pela especificação e seu uso é desencorajado, pois poderá ser removida no futuro.

Extends

Members


attributes :module:@nginstack/engine/lib/dom/NamedNodeMap~NamedNodeMap

Retorna uma coleção de todos os atributos registrados para um nó especificado. É um module:@nginstack/engine/lib/dom/NamedNodeMap~NamedNodeMap, e não um Array, então não há os métodos de um Array e os nós indexados module:@nginstack/engine/lib/dom/Attr~Attr podem ser diferentes entre os navegadores. Para ser mais específico, attributes é um par de chave/valor de strings que representa qualquer informação relacionada ao atributo.

Type:

<readonly> childNodes :module:@nginstack/engine/lib/dom/NodeList~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:
Inherited From:

<readonly> firstChild :module:@nginstack/engine/lib/dom/Node~Node

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

Type:
Inherited From:

<readonly> lastChild :module:@nginstack/engine/lib/dom/Node~Node

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

Type:
Inherited From:

<readonly> namespaceURI :string

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

Type:
  • string
Inherited From:
Deprecated:
  • Yes

<readonly> nextSibling :module:@nginstack/engine/lib/dom/Node~Node

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

Type:
Inherited From:

<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
Inherited From:

<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| ''
Inherited From:

<readonly> nodeValue :string

Retorna ou define o valor do nó atual.

Type:
  • string
Inherited From:

<readonly> ownerDocument :module:@nginstack/engine/lib/dom/Document~Document

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

Type:
Inherited From:

<readonly> parentNode :module:@nginstack/engine/lib/dom/Node~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:
Inherited From:

<readonly> prefix :string

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

Type:
  • string
Inherited From:

<readonly> previousSibling :module:@nginstack/engine/lib/dom/Node~Node

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

Type:
Inherited From:

tagName :string

Nome da tag para o elemento em questão.

Type:
  • string

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 module:@nginstack/engine/lib/dom/Node~Node

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

Inherited From:
Returns:

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

Type
module:@nginstack/engine/lib/dom/Node~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.

Inherited From:
Returns:

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

Type
module:@nginstack/engine/lib/dom/Node~Node

getAttribute(qualifiedName)

Obtém o valor de um atributo a partir do seu nome.

Parameters:
Name Type Description
qualifiedName string

Nome do atributo do qual se deseja obter o valor.

Returns:

Valor do atributo. Será retornada uma string vazia caso o atributo não exista.

Type
string

getAttributeNode(qualifiedName)

Retorna o atributo informado como uma instância de module:@nginstack/engine/lib/dom/Attr~Attr.

Parameters:
Name Type Description
qualifiedName string

Nome do atributo que será obtido.

Returns:

Instância de Attr representando o nome e valor do atributo.

Type
module:@nginstack/engine/lib/dom/Attr~Attr

getElementsByTagName(tagName)

Retorna uma module:@nginstack/engine/lib/dom/NodeList~NodeList com todos os elementos na ordem em que foram definidos no documento com o nome de tag informado e que estão contidos na subárvore deste elemento.

Parameters:
Name Type Description
tagName string

O nome da tag para realizar a pesquisa. O valor especial "*" obtém todas as tags. Para XML, o parâmetro tagName é case-sensitive, em outros casos ele dependerá da sensibilidade ao case da linguagem markup utilizada.

Returns:

Lista com os elementos com a tag informada.

Type
module:@nginstack/engine/lib/dom/NodeList~NodeList

hasChildNodes()

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

Inherited From:
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 module:@nginstack/engine/lib/dom/Node~Node

O nó a ser inserido.

refChild module:@nginstack/engine/lib/dom/Node~Node

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

Inherited From:
Returns:

O nó sendo inserido, que é newChild.

Type
module:@nginstack/engine/lib/dom/Node~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.

Inherited From:

removeAttribute(qualifiedName)

Remove um atributo do elemento.

Parameters:
Name Type Description
qualifiedName string

Nome do atributo que será removido.


removeChild(oldChild)

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

Parameters:
Name Type Description
oldChild module:@nginstack/engine/lib/dom/Node~Node

É o nó filho a ser removido do DOM.

Inherited From:
Returns:

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

Type
module:@nginstack/engine/lib/dom/Node~Node

replaceChild(newChild, oldChild)

Substitui o elemento filho especificado por outro.

Parameters:
Name Type Description
newChild module:@nginstack/engine/lib/dom/Node~Node

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

oldChild module:@nginstack/engine/lib/dom/Node~Node

É o elemento existente que será substituído.

Inherited From:
Returns:

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

Type
module:@nginstack/engine/lib/dom/Node~Node

setAttribute(qualifiedName, value)

Adiciona um novo atributo ou modifica o valor de um atributo existente.

Parameters:
Name Type Description
qualifiedName string

Nome do atributo ao qual se deseja atribuir o valor.

value string

Novo valor do atributo.


setAttributeNode(attr)

Adiciona ou substitui um atributo do elemento fazendo uso de uma instância de module:@nginstack/engine/lib/dom/Attr~Attr.

Parameters:
Name Type Description
attr module:@nginstack/engine/lib/dom/Attr~Attr

Novo valor do atributo que será adicionado ou substituído.

Returns:

Atributo que foi substituído, caso houvesse um anterior antes da atribuição.

Type
module:@nginstack/engine/lib/dom/Attr~Attr