Método XML DOM getElementById()

Manual de referência do objeto Document

Definição e uso

O método getElementById() busca o elemento com o ID específico único.

Sintaxe:

getElementById(elementid)
Parâmetros Descrição
elementid O valor do atributo id do elemento que você deseja obter.

Retorno

Representa o nó Element que possui a propriedade id específica do elemento do documento. Se não encontrar tal elemento, retornará null.

Descrição

Este método recuperará o valor da propriedade id elementid do nó de elemento e retornará ele. Se não encontrar tal elemento, retornará null. O valor da propriedade id é único no documento, se este método encontrar mais de um com o valor id especificado elementid do nó de elemento, que retornará aleatoriamente um tal nó de elemento ou retornará null.

Esta é uma método comum e importante, pois oferece uma maneira conveniente de obter o objeto Element que representa o elemento específico do documento.

Atenção:O nome do método termina com Id, não ID, não cometa erros de digitação.

No documento HTML, este método sempre recupera o atributo com o id especificado. Você pode usar Método getElementByName() do HTMLDocument, para encontrar elementos HTML com base no valor da propriedade name.

No documento XML, este método usa qualquer atributo do tipo id para encontrar, independentemente do nome do atributo. Se o tipo do atributo XML for desconhecido (por exemplo, o parser de XML ignorou ou não pode localizar o DTD do documento), o método sempre retorna null. Este método não é frequentemente usado com documentos XML no JavaScript do cliente. De fato, getElementById() foi originalmente definido como um membro da interface HTMLDocument, mas foi movido para a interface Document no nível 2 do DOM.

Ver

getElementsByTagName() do Document

getElementsByTagName() do Element

HTMLDocument.getElementByName()

Manual de referência do objeto Document