HTML DOM Dokumen Method getElementsByName()

Definisi dan penggunaan

getElementsByName() Method kembalikan koleksi elemen yang mempunyai nama yang ditentukan.

getElementsByName() Method kembalikan yang sebenar NodeList.

NodeList

NodeList Adalah koleksi node yang seperti array (senarai).

Buat akses ke node dalam senarai melalui indeks. Indeks bermula daripada 0.

length Kembalikan bilangan node dalam senarai yang dihasilkan.

Lihat juga:

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