HTML DOM Document getElementsByName() 方法

定义和用法

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

getElementsByName() 方法返回实时的 NodeList。

NodeList

NodeList 是类似数组的节点集合（列表）。

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

length 属性返回列表中的节点数。

Muut参照：

getElementById() -menetelmä

getElementsByTagName() -menetelmä

getElementsByClassName() -menetelmä

querySelector() -menetelmä

querySelectorAll() -menetelmä

NodeList viittausoppikirja

Esimerkki

Esimerkki 1

Hanki kaikki nimeltä "fname" olevat elementit:

let elements = document.getElementsByName("fname");

Kokeile itse

Esimerkki 2

Palauta name="animal" elementtien määrä:

let num = document.getElementsByName("animal").length;

Kokeile itse

Esimerkki 3

Tarkista kaikki type="checkbox" ja nimeltä "animal" olevat <input>-elementit:

const collection = document.getElementsByName("animal");
for (let i = 0; i < collection.length; i++) {
  if (collection[i].type == "checkbox") {
    collection[i].checked = true;
  }
}

Kokeile itse

Syntaksi

document.getElementsByName(name)

Parameteri

Parameteri Kuvaus
name Välttämätön. Elementin name-ominaisuuden arvo.

Palautusarvo

Tyyppi Kuvaus
Objekti

NodeList-objekti.

Nimellä varustetun elementtien joukko.

Järjestetään elementtien esiintymisjärjestykseen.

Selaimen tuki

document.getElementsByName() Se on DOM Level 1 (1998) ominaisuus.

Kaikki selaimet tukevat sitä:

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