目录

HTML DOM 文档 getElementsByName()

示例

获取名称为 "fname" 的所有元素:

let elements = document.getElementsByName("fname");
亲自试一试 »

name="animal" 的元素数量:

let num = document.getElementsByName("animal").length;
亲自试一试 »

下面有更多示例。


描述

这个getElementsByName()方法返回具有指定名称的元素的集合。

这个getElementsByName()方法返回一个live节点列表


节点列表

节点列表是一个类似数组的节点集合(列表)。

链表中的节点可以通过索引来访问。索引从 0 开始。

长度波珀蒂返回列表中的节点数。



语法

document.getElementsByName( name)

参数

Parameter Description
name Required.
The value of the element's name attribute.

返回值

类型 描述
对象 NodeList 对象
具有指定名称的元素的集合。
元素按照它们在文档中出现的方式进行排序。


更多示例

检查所有 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()是 DOM Level 1 (1998) 功能。

所有浏览器都完全支持它:

Chrome Edge Firefox Safari Opera IE
Yes Yes Yes Yes Yes 9-11