Element.getElementsByTagNameNS()
The Element.getElementsByTagNameNS()
method returns a
live HTMLCollection
of elements with the given tag name belonging to the
given namespace. It is similar to Document.getElementsByTagNameNS
, except
that its search is restricted to descendants of the specified element.
Syntax
getElementsByTagNameNS(namespaceURI, localName)
Parameters
-
namespaceURI
is the namespace URI of elements to look for (seeElement.namespaceURI
andAttr.namespaceURI
). For example, if you need to look for XHTML elements, use the XHTML namespace URI,http://www.w3.org/1999/xhtml
. -
localName
is either the local name of elements to look for or the special value"*"
, which matches all elements (seeElement.localName
andAttr.localName
).
Return value
A live HTMLCollection
of found elements in the order they appear in the tree.
Examples
// check the alignment on a number of cells in a table in an XHTML document.
const table = document.getElementById("forecast-table");
const cells = table.getElementsByTagNameNS("http://www.w3.org/1999/xhtml", "td");
for (let i = 0; i < cells.length; i++) {
const axis = cells[i].getAttribute("axis");
if (axis == "year") {
// grab the data
}
}
Specifications
Specification |
---|
DOM Standard # dom-element-getelementsbytagnamens |
Browser compatibility
BCD tables only load in the browser