Element.getElementsByTagNameNS()

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

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, http://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 (en-US)).

Ejemplo

// 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("http://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 Estado Comentario
DOM
La definición de 'Element.getElementsByTagNameNS()' en esta especificación.		 Living Standard Cambió el valor devuelto de NodeList a HTMLCollection.
Document Object Model (DOM) Level 3 Core Specification
La definición de 'Element.getElementsByTagNameNS()' en esta especificación.		 Obsolete Sin cambios desde Document Object Model (DOM) Level 2 Core Specification.
Document Object Model (DOM) Level 2 Core Specification
La definición de 'Element.getElementsByTagNameNS()' en esta especificación.		 Obsolete Definición inicial

Compatibilidad con los navegadores

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help! (en-US)

Característica Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Soporte básico 1.0[1] (Yes) (Yes)[2] 5.5 (Yes)[1] (Yes)[1]
getElementsByTagName("*") 1.0 (Yes) (Yes) 6.0 (Yes) (Yes)
Característica Android Edge Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Soporte básico (Yes) (Yes) (Yes)[2] (Yes) (Yes) (Yes)

[1] Inicialmente, este método devolvía una NodeList; luego fue modificado para reflejar el cambio en la especificación.

[2] El comportamiento de element.getElementsByTagNameNS cambió entre Firefox 3.5 y Firefox 3.6. En Firefox 3.5 y anteriores, esta función automáticamente convertía mayúsculas o minúsculas en las consultas, de manera que una búsqueda de "foo" encontraría "Foo" o "foo". En Firefox 3.6 y posteriores esta función es sensible a mayúsculas y minúsculas, por lo que una consulta por "foo" sólo encontrará "foo" y no "Foo". Para más información al respecto, por favor vea el comentario de Henri Sivonen sobre este cambio. También puede ver la parte relevante del estándar, que establece qué partes de la API son sensibles a mayúsculas y minúsculas y qué partes no.

Previo a Firefox 19, este método devolvía una NodeList; luego fue modificado para reflejar el cambio en la especificación.