HTML DOM Document getElementsByName() metoden

Definition og brug

getElementsByName() Metoden returnerer en samling af elementer med angivet navn.

getElementsByName() Metoden returnerer en NodeList.

NodeList

NodeList Er en nodekollektion, der ligner en array (liste).

Noder i listen kan tilgås via indeks. Indekset starter ved 0.

length Returnerer antallet af noder i listen.

Se også:

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