指定した name 属性値を持つ (X)HTML 文書内のノードリストを返します。
構文
elements = document.getElementsByName(name)
elements: 現在のNodeListコレクション。name: 要素のname属性の値。
例
<!DOCTYPE html>
<html lang="en">
<head>
...
</head>
<body>
<form name="up"><input type="text"></form>
<div name="down"><input type="text"></div>
<script>
var up_forms = document.getElementsByName("up");
console.log(up_forms[0].tagName); // returns "FORM"
</script>
</body>
</html>
注記
name 属性は、(X)HTML 文書にのみ適用可能です。このメソッドは、与えた name 属性の値を持つすべての要素を含む、現在の NodeList コレクションを返します。<meta> や <object>、または name 属性を要素内に置くことが全くサポートされていないものも name 属性が付いていれば含まれます。
getElementsByName() メソッドは、ブラウザごとに動作が異なります。IE や Opera では、getElementsByName() メソッドは、指定した値の id 属性を持つ要素も返します。そのため、name と ID に同じ文字列を使用しないように、よく注意しなければなりません。
仕様
| 仕様書 | 策定状況 | 備考 |
|---|---|---|
| WHATWG HTML Living Standard Document.getElementsByName() の定義 |
現行の標準 | |
| Document Object Model (DOM) Level 2 HTML Specification Document.getElementsByName() の定義 |
勧告 | 初期定義 |
関連情報
document.getElementById()は、ID による要素への参照を返します。document.querySelector()は、'div.myclass'のようなクエリで選択します。