Document オブジェクトの getElementsByName() メソッドは、文書内で指定した name を持つ要素の NodeList コレクションを返します。
構文
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() の定義 |
廃止された | 初回定義 |
ブラウザーの対応
このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。
Update compatibility data on GitHub
| デスクトップ | モバイル | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
getElementsByName | Chrome 完全対応 1 | Edge
完全対応
12
| Firefox 完全対応 あり | IE
完全対応
あり
| Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
凡例
- 完全対応
- 完全対応
- 実装ノートを参照してください。
- 実装ノートを参照してください。
関連情報
document.getElementById(): 固有のidを持つ要素への参照を返すdocument.getElementsByTagName(): 同じタグ名の要素への参照を返すdocument.querySelector():'div.myclass'のような CSS セレクターによって要素への参照をかえす