Objeto Element do XML DOM

Objeto Element

O objeto Element representa um elemento no documento XML. O elemento pode conter atributos, outros elementos ou texto. Se o elemento contiver texto, ele é representado no nó de texto.

Ponto importante:O texto sempre é armazenado no nó de texto. Um erro comum no processo de manipulação do DOM é navegar até o nó de elemento e acreditar que esse nó contém texto. No entanto, até mesmo o nó de elemento mais simples possui um nó de texto. Por exemplo, em <year>2005</year>, há um nó de elemento (year), e abaixo desse nó existe um nó de texto que contém o texto (2005).

Como o objeto Element também é um nó, ele pode herdar as propriedades e métodos do objeto Node.

Propriedades do objeto Element.

Atributos Descrição
attributes Retorna o NamedNodeMap da propriedade do elemento.
baseURI Retorna o URI de base absoluto do elemento.
childNodes Retorna NodeList de nós filhos do elemento.
firstChild Retorna o primeiro nó filho do elemento.
lastChild Retorna o último nó filho do elemento.
localName Retorna a parte local do nome do elemento.
namespaceURI Retorna o URI de espaço de nomes do elemento.
nextSibling Retorna o nó imediatamente após o elemento.
nodeName Retorna o nome do nó, dependendo do seu tipo.
nodeType Retorna o tipo do nó.
ownerDocument Retorna o elemento raiz (objeto documento).
parentNode Retorna o nó pai do elemento.
prefix Definir ou retornar o prefixo de espaço de nomes do elemento.
previousSibling Retorna o nó imediatamente antes do elemento.
schemaTypeInfo Retorna as informações de tipo associadas ao elemento.
tagName Retorna o nome do elemento.
textContent Definir ou retornar o conteúdo de texto do elemento e seus descendentes.

Métodos do objeto Element

Método Descrição
appendChild() Adicionar um novo nó filho ao final da lista de nós filhos deste nó.
cloneNode() Clonar nó.
compareDocumentPosition() Comparar a posição do documento de dois nós.
getAttribute() Retorna o valor do atributo.
getAttributeNS() Retorna o valor do atributo (com espaço de nomes).
getAttributeNode() Retorna o nó de atributo como objeto Attribute.
getAttributeNodeNS() Retorna o nó de atributo (com espaço de nomes) como objeto Attribute.
getElementsByTagName() Retorna NodeList de nós de elementos que coincidem com o nó de elemento e seus descendentes.
getElementsByTagNameNS() Retorna NodeList de nós de elementos que coincidem com o nó de elemento (com espaço de nomes) e seus descendentes.
getFeature(feature,version) Retorna o objeto DOM que implementa a API específica de características e versão.
getUserData(key) Retorna o objeto associado à chave do nó. Primeiro, é necessário definir o objeto neste nó, usando o mesmo chave para chamar setUserData.
hasAttribute() Retorna se o elemento possui um atributo que coincide com o nome especificado.
hasAttributeNS() Retornar se o elemento possui atributo que coincide com o nome e o espaço de nomes especificados.
hasAttributes() Retornar se o elemento possui atributos.
hasChildNodes() Retornar se o elemento tem nós filhos.
insertBefore() Inserir novo nó filho antes do nó filho existente.
isDefaultNamespace(URI) Retornar se o namespaceURI especificado é o padrão.
isEqualNode() Verificar se dois nós são iguais.
lookupNamespaceURI() Retornar a URI de espaço de nomes que coincide com o prefixo especificado.
lookupPrefix() Retornar o prefixo que coincide com a URI de espaço de nomes especificada.
normalize()

O método normalize() remove nós de texto vazios e conecta nós de texto adjacentes.

Normalizar todos os nós de texto sob o elemento (inclusive atributos), onde apenas a estrutura (por exemplo, elementos, comentários, instruções de processamento, partes CDATA e referências a entidades) separa os nós de texto.

Ou seja, não existem nós de texto adjacentes nem nós de texto vazios.
removeAttribute() Remover atributo especificado.
removeAttributeNS() Remover atributo especificado (com espaço de nomes).
removeAttributeNode() Remover nó de atributo especificado.
removeChild() Remover nó filho.
replaceChild() Substituir nó filho.
setUserData(key,data,handler) Associar o objeto com a chave no elemento.
setAttribute() Adicionar novo atributo.
setAttributeNS() Adicionar novo atributo (com espaço de nomes).
setAttributeNode() Adicionar novo nó de atributo.
setAttributeNodeNS(attrnode) Adicionar novo nó de atributo (com espaço de nomes).
setIdAttribute(name,isId) Se o atributo isId do objeto Attribute for true, este método declara a propriedade especificada como atributo ID determinado pelo usuário.
setIdAttributeNS(uri,name,isId) Se o atributo isId do objeto Attribute for true, este método declara a propriedade especificada (com espaço de nomes) como atributo ID determinado pelo usuário.
setIdAttributeNode(idAttr,isId) Se o atributo isId do objeto Attribute for true, este método declara a propriedade especificada como atributo ID determinado pelo usuário.