Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.
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)
elementoses unaHTMLCollectionviva de elementos encontrados en el orden en el que aparecen en el árbol.elementoes 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í.espacioNombreURIes 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
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!
| 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.