Skip to main content

Visit Mozilla.org

DOM:element.getElementsByTagName

De MDC


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


« Referencia DOM de Gecko

Tabla de contenidos

[editar] 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.

[editar] 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".

[editar] 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 
    }
}

[editar] Notas

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

[editar] Especificación

DOM Level 2 Core: Element.getElementsByTagName

Obtenido de "http://developer.mozilla.org/es/docs/DOM:element.getElementsByTagName"