element.getElementsByTagName

 

Imagen:traduccion-pendiente.png Esta página está traduciéndose a partir del artículo DOM:element.getElementsByTagName, razón por la cual puede haber algunos errores sintácticos o partes sin traducir. Puedes colaborar continuando con la traducción


Resumen

Devuelve una lista de elementos que tienen un tag name determinado. Se explora el árbol por debajo del elemento dado, excluyendo el propio elemento.

Sintaxis

elements =element.getElementsByTagName(tagName) 
  • elements es un NodeList del elemento encontrado en el orden en que aparece en el árbol.
  • element es el elemento a partir del cual debe empezar la búsqueda. Recuerda que sólo se buscan los elementos descendentes del elemento dado, sin incluir el propio elemento.
  • tagName es el nombre que se busca. La cadena especial "*" representa todos los elementos.

En Firefox 2 (Gecko 1.8.1) y anteriores, este método no funcionaba correctamente si el árbol contenía algún elemento con etiqueta de nombre conteniendo espacios. (Ver bug 206053 para más detalles).

Es recomendable usar DOM:document.getElementsByTagNameNS cuando se manejan documentos con "multi-namespace".

Ejemplo

// comprueba la alineación de las celdas en una tabla. 
var table = document.getElementById("forecast-table"); 
var cells = table.getElementsByTagName("td"); 
for (var i = 0; i < cells.length; i++) { 
    status = cells[i].getAttribute("status"); 
    if ( status == "open") { 
        // grab the data 
    }
}

Notas

element.getElementsByTagName es similar a document.getElementsByTagName, excepto por que su búsqueda está restringida a los elementos que descienden del elemento especificado.

Especificación

DOM Level 2 Core: Element.getElementsByTagName

 

 

 

Etiquetas y colaboradores del documento

 Colaboradores en esta página: fscholz, khalid32, Mgjbot, HenryGR
 Última actualización por: khalid32,