Element: getElementsByTagNameNS() method
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
js
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
js
// 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 (const cell of cells) {
const axis = cell.getAttribute("axis");
if (axis === "year") {
// Grab the data
}
}
Specifications
Specification |
---|
DOM Standard # dom-element-getelementsbytagnamens |
Browser compatibility
BCD tables only load in the browser