los getElementsByTagName método de Document la interfaz devuelve un HTMLCollection de elementos con el nombre de etiqueta dado. Se busca en el documento completo, incluido el nodo raíz. El retorno HTMLCollection está en vivo, lo que significa que se actualiza automáticamente para permanecer sincronizado con el árbol DOM sin tener que llamar document.getElementsByTagName() de nuevo.

Sintaxis

var elements = document.getElementsByTagName(name);
  • elementos es una vida HTMLCollection (pero vea la nota a continuación) de los elementos encontrados en el orden en que aparecen en el árbol.
  • nombre es un string que representa el nombre de los elementos. El especial string “*” representa todos los elementos.

La última especificación W3C dice elementos es un HTMLCollection; sin embargo, este método devuelve un NodeList en los navegadores WebKit. Ver error 14869 para detalles.

Ejemplo

En el siguiente ejemplo, getElementsByTagName() comienza desde un elemento principal en particular y busca de arriba hacia abajo de forma recursiva a través del DOM desde ese elemento principal, creando una colección de todos los elementos descendientes que coinciden con la etiqueta name parámetro. Esto demuestra tanto document.getElementsByTagName() y el funcionalmente idéntico Element.getElementsByTagName(), que inicia la búsqueda en un elemento específico dentro del árbol DOM.

Al hacer clic en los botones se usa getElementsByTagName() para contar los elementos de párrafo descendientes de un padre en particular (ya sea el documento en sí o uno de los dos anidados

elementos).

DOCTYPEhtml><htmllang="en"><head><metacharset="UTF-8"/><title>getElementsByTagName exampletitle><script>functiongetAllParaElems()var allParas = document.getElementsByTagName('p');var num = allParas.length;alert('There are '+ num +' paragraph in this document');functiondiv1ParaElems()var div1 = document.getElementById('div1');var div1Paras = div1.getElementsByTagName('p');var num = div1Paras.length;alert('There are '+ num +' paragraph in #div1');functiondiv2ParaElems()var div2 = document.getElementById('div2');var div2Paras = div2.getElementsByTagName('p');var num = div2Paras.length;alert('There are '+ num +' paragraph in #div2');script>head><bodystyle="border: solid green 3px"><p>Some outer textp><p>Some outer textp><divid="div1"style="border: solid blue 3px"><p>Some div1 textp><p>Some div1 textp><p>Some div1 textp><divid="div2"style="border: solid red 3px"><p>Some div2 textp><p>Some div2 textp>div>div><p>Some outer textp><p>Some outer textp><buttononclick="getAllParaElems();">
    show all p elements in documentbutton><br/><buttononclick="div1ParaElems();">
    show all p elements in div1 elementbutton><br/><buttononclick="div2ParaElems();">
    show all p elements in div2 elementbutton>body>html>

Notas

Cuando se llama en un documento HTML, getElementsByTagName() en minúsculas su argumento antes de proceder. Esto no es deseable cuando se intenta hacer coincidir los elementos SVG de camelCase en un subárbol en un documento HTML. document.getElementsByTagNameNS() es útil en ese caso. Ver también error 499656.

document.getElementsByTagName() es parecido a Element.getElementsByTagName(), excepto que su búsqueda abarca todo el documento.

Especificaciones

Especificación Estado Comentario
DOM
La definición de ‘document.getElementsByTagName’ en esa especificación.		 Estándar de vida

Compatibilidad del navegador

Escritorio Móvil
Cromo Borde Firefox explorador de Internet Ópera Safari WebView Android Chrome Android Firefox para Android Opera Android Safari en IOS Internet de Samsung
getElementsByTagName 1 12 1 5 5.1 1 1 18 4 10.1 1 1.0

Ver también

  • Element.getElementsByTagName()
  • document.getElementById() para devolver una referencia a un elemento por su id
  • document.getElementsByName() para devolver una referencia a un elemento por su name
  • document.querySelector() para selectores potentes a través de consultas como 'div.myclass'