Element: getElementsByTagNameNS() メソッド

Element.getElementsByTagNameNS() メソッドは、指定された名前空間に属する、指定されたタグ名を持つ要素の HTMLCollection をライブで返します。これは Document.getElementsByTagNameNS に似ていますが、検索対象が指定された要素の子孫に限定される点が異なります。

構文

js
getElementsByTagNameNS(namespaceURI, localName)

引数

  • namespaceURI は検索する要素の名前空間 URI です（Element.namespaceURI および Attr.namespaceURI を参照してください）。例えば、XHTML 要素を検索する場合は、XHTML の名前空間 URI である http://www.w3.org/1999/xhtml を使用してください。
  • localName は検索する要素のローカル名、またはすべての要素に一致する特殊な値 "*" です（Element.localName および Attr.localName を参照）。

返値

生きた HTMLCollection で、ツリー内で見つかった要素を出現順に保持します。

例

js
// XHTML 文書の table の多くのセルの配列をチェック。
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") {
    // データを取得
  }
}

仕様書

Specification
DOM Standard
# dom-element-getelementsbytagnamens

ブラウザーの互換性

BCD tables only load in the browser