Document.getElementsByName()

Document オブジェクトの getElementsByName() メソッドは、文書内で指定した name を持つ要素の NodeList コレクションを返します。

構文

var elements = document.getElementsByName(name);
  • elements は、生きた NodeList コレクション、つまり文書内で同じ name を持った新しい要素が追加されたり削除されたりすると自動的に更新されるものです。
  • name は、要素の name 属性の値です。

例

html
<!doctype html>
<html lang="en">
  <title>document.getElementsByName の使用例</title>

  <input type="hidden" name="up" />
  <input type="hidden" name="down" />

  <script>
    var up_names = document.getElementsByName("up");
    console.log(up_names[0].tagName); // "INPUT" と表示
  </script>
</html>

メモ

name 属性は、(X)HTML 文書にのみ適用可能です。

返却された NodeList コレクションには、 <meta> や <object> など、それに name 属性にまったく対応していない要素も含め、指定された name を持つすべての要素が含まれます。

警告: getElementsByName メソッドは、 IE10 以前では動作が異なります。この場合、 getElementsByName() は指定された id 属性を持つ要素も返します。 name および id で同じ文字列を使用しないように注意してください。

警告: getElementsByName メソッドは IE では動作が異なります。この場合、 getElementsByName() は name 属性を許容しない要素 (<span> など) を返しません。

警告: IE および Edge では、 NodeList ではなく HTMLCollection を返します。

仕様書

Specification
HTML Standard
# dom-document-getelementsbyname-dev

ブラウザーの互換性

BCD tables only load in the browser

関連情報