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 newChildmodule:@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.
-
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 deepboolean 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.
-
getAttribute(qualifiedName)
-
Obtém o valor de um atributo a partir do seu nome.
Parameters:
Name Type Description qualifiedNamestring 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 qualifiedNamestring Nome do atributo que será obtido.
Returns:
Instância de Attr representando o nome e valor do atributo.
-
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 tagNamestring 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.
-
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 newChildmodule:@nginstack/engine/lib/dom/Node~Node O nó a ser inserido.
refChildmodule:@nginstack/engine/lib/dom/Node~Node O nó antes do qual o newChild será inserido.
- Inherited From:
Returns:
O nó sendo inserido, que é newChild.
-
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 qualifiedNamestring Nome do atributo que será removido.
-
removeChild(oldChild)
-
Remove um nó filho do DOM. Devolve o nó removido.
Parameters:
Name Type Description oldChildmodule:@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.
-
replaceChild(newChild, oldChild)
-
Substitui o elemento filho especificado por outro.
Parameters:
Name Type Description newChildmodule:@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.
oldChildmodule:@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.
-
setAttribute(qualifiedName, value)
-
Adiciona um novo atributo ou modifica o valor de um atributo existente.
Parameters:
Name Type Description qualifiedNamestring Nome do atributo ao qual se deseja atribuir o valor.
valuestring 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 attrmodule:@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.