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 |
