→、
Document 内の指定名前空間で指定タグ名を持つ要素のリストを 返します。
ルート ノードを含め、文書全体が検索されます。
Document | Document。 |
---|---|
namespace | 検索する要素の名前空間 URI です(element.namespaceURI を参照)。→Document.createElementNS() |
name | 検索する要素の局所名、またはすべての要素に一致する特殊な値 * です(element.localName を参照)。 |
見つかった要素の生きた NodeList(但し下記のメモを参照)で、ツリーに現れる順です。
注: W3C の仕様書では戻り値は NodeList であるとされていますが、Gecko および Internet Explorer ではこのメソッドは HTMLCollection を返します。Opera は NodeList を返しますが、namedItem メソッドを実装しているので、HTMLCollection と同様になります。2012年1月時点で、WebKit ブラウザーのみが純粋な NodeList の値を返します。詳しくは を参照してください。
注: 現在、このメソッドの引数は大文字と小文字を区別しますが、Firefox 3.5 以前は大文字と小文字を区別していませんでした。詳しくは および Element.getElementsByTagNameNS のブラウザーの互換性のメモをご覧ください。
¶例省く