HTML DOM Document getElementsByName()
示例
獲取所有名為 "fname" 的元素
let elements = document.getElementsByName("fname");
自己動手試一試 »
名為 "animal" 的元素數量
let num = document.getElementsByName("animal").length;
自己動手試一試 »
更多示例見下文。
描述
getElementsByName() 方法返回具有指定名稱的元素集合。
getElementsByName() 方法返回一個即時的 NodeList。
NodeList（節點列表）
NodeList 是一個類似陣列的節點集合（列表）。
列表中的節點可以透過索引訪問。索引從 0 開始。
length 屬性 返回列表中節點的數量。
另請參閱
語法
document.getElementsByName(name)
引數
| 引數 | 描述 |
| name | 必需。 元素 name 屬性的值。 |
返回值
| 型別 | 描述 |
| 物件 | 一個 NodeList 物件. 具有指定名稱的元素集合。 元素按其在文件中出現的順序排序。 |
更多示例
選中所有 type="checkbox" 且 name="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() 是 DOM Level 1 (1998) 的一個特性。
所有瀏覽器都完全支援。
| Chrome | Edge | Firefox | Safari | Opera | IE |
| 是 | 是 | 是 | 是 | 是 | 9-11 |
