HTML DOM Document getElementsByName() Methode

Definitie en gebruik

getElementsByName() Methode retourneert een verzameling elementen met de opgegeven naam.

getElementsByName() De methode retourneert een NodeList.

NodeList

NodeList Is een verzameling knopen vergelijkbaar met een array (lijst).

Knopen in de lijst kunnen worden bereikt via index. De index begint bij 0.

length Eigenschap retourneert het aantal knopen in de lijst.

Zie ook:

getElementById() Methode

getElementsByTagName() Methode

getElementsByClassName() Methode

querySelector() Methode

querySelectorAll() Methode

NodeList Referentiemanual

Voorbeeld

Voorbeeld 1

Haal alle elementen met naam "fname" op:

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

Probeer het zelf

Voorbeeld 2

Retourneer het aantal elementen met name="animal":

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

Probeer het zelf

Voorbeeld 3

Controleer alle <input>-elementen met type="checkbox" en naam "animal":

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

Probeer het zelf

Syntax

document.getElementsByName(name)

Parameter

Parameter Beschrijving
name Verplicht. De waarde van het name-eigenschap van het element.

Retourwaarde

Type Beschrijving
Object

NodeList object.

Verzameling van elementen met een specifieke naam.

Wordt gesorteerd op de volgorde waarin de elementen in het document verschijnen.

Browserondersteuning

document.getElementsByName() is een kenmerk van DOM Level 1 (1998).

Het wordt ondersteund door alle browsers:

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