HTML DOM 文档 getElementsByName()
示例
获取所有名为“fname”的元素
let elements = document.getElementsByName("fname");
试一试 »
名为“animal”的元素数量
let num = document.getElementsByName("animal").length;
试一试 »
更多示例如下。
描述
The getElementsByName() 方法返回具有指定名称的元素集合。
The getElementsByName() 方法返回一个实时的 NodeList。
NodeList
A NodeList 是一个类似数组的节点集合（列表）。
列表中的节点可以通过索引访问。索引从 0 开始。
长度属性 返回列表中节点的数量。
另请参阅
语法
document.getElementsByName(name)
参数
| 参数 | 描述 |
| name | 必需的。 元素的 name 属性值。 |
返回值
| 类型 | 描述 |
| 对象 | NodeList 对象. 具有指定名称的元素集合。 元素按它们在文档中的出现顺序排序。 |
更多示例
检查所有类型为“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() 是 DOM Level 1 (1998) 的功能。
它在所有浏览器中都得到完全支持
| Chrome | Edge | Firefox | Safari | Opera | IE |
| 是 | 是 | 是 | 是 | 是 | 9-11 |
