Método XML DOM getElementById()

Manual de referencia del objeto Document

Definición y uso

El método getElementById() busca el elemento con un ID único especificado.

Sintaxis:

getElementById(elementid)
Parámetros Descripción
elementid El valor del atributo id del elemento que desea obtener.

Valor de retorno

Representa el nodo Element del elemento de documento que tiene el atributo id especificado. Si no se encuentra tal elemento, se devolverá null.

Descripción

Este método buscará el valor del atributo id elementid del nodo de elemento y devolverá uno de ellos. Si no se encuentra tal elemento, se devolverá null. El valor del atributo id en el documento es único, si este método encuentra más de uno con el id especificado elementid del nodo de elemento, que devolverá aleatoriamente un nodo de elemento de este tipo o null.

Esta es una técnica común y importante, ya que proporciona un método fácil para obtener el objeto Element que representa el elemento de documento específico.

Nota:El nombre del método termina con Id, no con ID, no lo escriba mal.

En el documento HTML, este método siempre recupera el atributo con el id especificado. Puede usar Método getElementByName() del HTMLDocument, buscando elementos HTML según el valor de su atributo name.

En el documento XML, este método utiliza cualquier atributo de tipo id para buscar, sin importar el nombre del atributo. Si el tipo de atributo XML es desconocido (por ejemplo, el analizador XML lo ignora o no puede ubicar el DTD del documento), este método siempre devuelve null. En JavaScript del cliente, este método no se utiliza a menudo con documentos XML. De hecho, getElementById() se definió originalmente como un miembro de la interfaz HTMLDocument, pero se movió al interfaz Document en el nivel 2 del DOM.

Ver

getElementsByTagName() del Documento

getElementsByTagName() del Elemento

HTMLDocument.getElementByName()

Manual de referencia del objeto Document