指定した 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() の定義
勧告 初期定義

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: Marsf, fscholz, khalid32, s_fujimoto, ethertank, Mgjbot, Hfjapancom
 最終更新者: Marsf,