構文
var elements = document.getElementsByName(name);
- elements は、生きた
NodeList
コレクション、つまり文書内で同じname
を持った新しい要素が追加されたり削除されたりすると自動的に更新されるものです。 name
は、要素のname
属性の値です。
例
<!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
を返します。
仕様書
仕様書 | 状態 | 備考 |
---|---|---|
HTML Living Standard Document.getElementsByName() の定義 |
現行の標準 | |
Document Object Model (DOM) Level 2 HTML Specification Document.getElementsByName() の定義 |
廃止された | 初回定義 |
ブラウザーの対応
BCD tables only load in the browser
このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。
関連情報
document.getElementById()
: 固有のid
を持つ要素への参照を返すdocument.getElementsByTagName()
: 同じタグ名の要素への参照を返すdocument.querySelector()
:'div.myclass'
のような CSS セレクターによって要素への参照をかえす