Metoda getElementsByName() obiektu HTML DOM Document

Definicja i użycie

getElementsByName() Metoda zwraca zbiór elementów o określonej nazwie.

getElementsByName() Metoda zwraca rzeczywisty NodeList.

NodeList

NodeList To zbiorowisko węzłów podobne do tablicy (lista).

Można uzyskać dostęp do węzłów w liście za pomocą indeksu. Indeksy zaczynają się od 0.

length Zwraca liczbę węzłów w liście zwróconej przez atrybut.

Proszę zobacz również:

Metoda getElementById()

Metoda getElementsByTagName()

Metoda getElementsByClassName()

Metoda querySelector()

Metoda querySelectorAll()

Podręcznik NodeList

Przykład

Przykład 1

Pobierz wszystkie elementy o nazwie "fname":

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

Spróbuj sam

Przykład 2

Zwróć liczbę elementów o name="animal":

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

Spróbuj sam

Przykład 3

Sprawdź wszystkie elementy <input> o type="checkbox" i nazwie "animal":

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

Spróbuj sam

Gramatyka

document.getElementsByName(name)

Parametr

Parametr Opis
name Wymagane. Wartość atrybutu name elementu.

Zwrócona wartość

Typ Opis
Obiekt

Obiekt NodeList.

Zbiór elementów o określonej nazwie.

Sortowane są zgodnie z kolejnością występowania elementów w dokumencie.

Wspierane przeglądarki

document.getElementsByName() To jest funkcja DOM Level 1 (1998).

Wszystkie przeglądarki wspierają to:

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