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