概要
与えられた名前空間に属し、与えられたタグの名前を持つ要素のリストを返します。
構文
elements =element.getElementsByTagNameNS(namespaceURI,localName)
elements
は見付かった要素のツリーに出現した順に生きたNodeList
です。element
は検索を始める要素です。この要素の子孫のみが検索対象になり、そのノード自身は対象になりません。namespaceURI
は検索される要素の名前空間 URI です(element.namespaceURI
を参照)。例えば、XHTML 要素を検索する必要があるなら、XHTML の名前空間 URIhttps://www.w3.org/1999/xhtml
を使ってください。localName
は探す要素のローカル名か全ての要素にマッチする特別な値"*"
のどちらかです(element.localName
参照)。
例
// XHTML 文書の table の多くのセルの配列をチェック。 var table = document.getElementById("forecast-table"); var cells = table.getElementsByTagNameNS("https://www.w3.org/1999/xhtml", "td"); for (var i = 0; i < cells.length; i++) { axis = cells[i].getAttribute("axis"); if ( axis == "year") { // データを取得 } }
注意
element.getElementsByTagNameNS
は document.getElementsByTagNameNS
に似ていますが、指定された要素の祖先に限定されるかが異なります。
仕様
DOM Level 2 Core: Element.getElementsByTagNameNS