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 unaHTMLCollection
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 (veaNode.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 (veaNode.localName
).
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
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.