HTML DOM Document getElementsByName() metod

Definition och användning

getElementsByName() Metoden returnerar en samling av element med angiven namn.

getElementsByName() Metoden returnerar en NodeList.

NodeList

NodeList Det är en nodkollektion som liknar en array (lista).

Du kan komma åt noder i listan via index. Index börjar vid 0.

length Egenskapen returnerar antalet noder i listan.

Vänligen se också:

getElementById() metoden

getElementsByTagName() metoden

getElementsByClassName() metoden

querySelector() metoden

querySelectorAll()-metoden

NodeList-vägledning

Exempel

Exempel 1

Hämta alla element med namn "fname":

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

Prova själv

Exempel 2

Returnerar antalet element med name="animal":

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

Prova själv

Exempel 3

Kontrollera alla <input>-element med type="checkbox" och namn "animal":

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

Prova själv

Syntaks

document.getElementsByName(name)

Parameter

Parameter Beskrivning
name Obligatoriskt. Värdet på elementets name-egenskap.

Returvärde

Typ Beskrivning
Objekt

NodeList-objekt.

En samling av element med specifikt namn.

Sorteras enligt elementens uppträdandeordning i dokumentet.

Webbläsarstöd

document.getElementsByName() Det är en DOM Level 1 (1998)-funktion.

Alla webbläsare stöder det:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Stöd 9-11 Stöd Stöd Stöd Stöd