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