HTML DOM Document getElementsByName() メソッド

定義と使用法

getElementsByName() メソッドは指定された名前を持つ要素集合を返します。

getElementsByName() メソッドはリアルタイムの NodeList。

NodeList

NodeList 配列に似たノード集合（リスト）です。

リスト内のノードにインデックスでアクセスできます。インデックスは0から始まります。

length 属性はリスト内のノード数を返します。

参照してください：

getElementById() メソッド

getElementsByTagName() メソッド

getElementsByClassName() メソッド

querySelector() メソッド

querySelectorAll() メソッド

NodeList リファレンスマニュアル

インスタンス

例 1

名前が "fname" のすべての要素を取得します：

let elements = document.getElementsByName("fname");

自分で試してみる

例 2

name="animal" の要素の数を返します：

let num = document.getElementsByName("animal").length;

自分で試してみる

例 3

type="checkbox" で名称が "animal" のすべての <input> 要素をチェックします：

const collection = document.getElementsByName("animal");
for (let i = 0; i < collection.length; i++) {
  if (collection[i].type == "checkbox") {
    collection[i].checked = true;
  }
}

自分で試してみる

文法

document.getElementsByName(name)

パラメータ

パラメータ 説明
name 必須。要素の name 属性の値。

返り値

タイプ 説明
オブジェクト

NodeList オブジェクト。

指定された名前を持つ要素の集合です。

要素がドキュメント内に現れる順序に基づいてソートされます。

ブラウザのサポート

document.getElementsByName() DOM Level 1 (1998) の機能です。

すべてのブラウザがサポートしています：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
サポート 9-11 サポート サポート サポート サポート