Esta página ha sido traducida del inglés por la comunidad. Aprende más y únete a la comunidad de MDN Web Docs.

View in English Always switch to English

Element.getElementsByTagNameNS()

Baseline
Ampliamente disponible

Esta característica está consolidada y funciona en muchos dispositivos y versiones de navegador. Está disponible en todos los navegadores desde julio de 2015.

El método Element.getElementsByTagNameNS() devuelve una HTMLCollection viva de elementos con el nombre de etiqueta dado perteneciente al espacio de nombres dado. Es similar a Document.getElementsByTagNameNS, con la excepción de que su búsqueda está limitada a los descendientes del elemento especificado.

Sintaxis

js
elementos = elemento.getElementsByTagNameNS(espacioNombreURI, nombreLocal);
  • elementos es una HTMLCollection viva de elementos encontrados en el orden en el que aparecen en el árbol.
  • elemento es el elemento desde el cual la búsqueda debería comenzar. Nótese que sólo los descendientes de este elemento están incluídos en la búsqueda, no el nodo en sí.
  • espacioNombreURI es el URI del espacio de nombres de los elementos a buscar (vea Node.namespaceURI). Por ejemplo, si usted necesita buscar elementos XHTML, use el URI de espacio de nombres de XHTML, https://www.w3.org/1999/xhtml.
  • nombreLocal puede ser el nombre local de los elementos a buscar o el valor especial "*", que encuentra todos los elementos (vea Node.localName).

Ejemplo

js
// verifica la alineación en un número de celdas en una tabla en un documento XHTML.
var table = document.getElementById("forecast-table");
var cells = table.getElementsByTagNameNS("https://www.w3.org/1999/xhtml", "td");

for (var i = 0; i < cells.length; i++) {
  var axis = cells[i].getAttribute("axis");
  if (axis == "year") {
    // obtiene los datos
  }
}

Especificaciones

Especificación
DOM
# dom-element-getelementsbytagnamens

Compatibilidad con navegadores