element.getElementsByTagNameNS

概要

与えられた名前空間に属し、与えられたタグの名前を持つ要素のリストを返します。

構文

elements = element.getElementsByTagNameNS(namespaceURI,localName)
  • elements は見付かった要素のツリーに出現した順に生きた NodeList です。
  • element は検索を始める要素です。この要素の子孫のみが検索対象になり、そのノード自身は対象になりません。
  • namespaceURI は検索される要素の名前空間 URI です(element.namespaceURI を参照)。例えば、XHTML 要素を検索する必要があるなら、XHTML の名前空間 URI http://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 に似ていますが、指定された要素の祖先に限定されるかが異なります。

仕様