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 支持 支持 支持 支持