Document: getElementsByName() メソッド

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

構文

js
getElementsByName(name)

引数

name

探している要素の name 属性の値です。

返値

生きた NodeList コレクション、つまり文書内で同じ name を持った新しい要素が追加されたり削除されたりすると自動的に更新されるものです。

html
<!doctype html>
<html lang="ja">
  <head>
    <title>document.getElementsByName の使用例</title>
  </head>
  <body>
    <input type="hidden" name="up" />
    <input type="hidden" name="down" />
  </body>
</html>
js
const up_names = document.getElementsByName("up");
console.log(up_names[0].tagName); // "INPUT" と表示

メモ

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

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

仕様書

Specification
HTML Standard
# dom-document-getelementsbyname-dev

ブラウザーの互換性

BCD tables only load in the browser

関連情報