Metodo getElementsByName() del documento HTML DOM

Definizione e uso

getElementsByName() Il metodo restituisce una raccolta di elementi con il nome specificato.

getElementsByName() Il metodo restituisce in tempo reale NodeList.

NodeList

NodeList È una raccolta di nodi simile a un array (lista).

I nodi nella lista possono essere acceduti tramite l'indice. L'indice parte da 0.

length Restituisce il numero di nodi nella lista restituita dalle proprietà.

Si prega di consultare anche:

Metodo getElementById()

Metodo getElementsByTagName()

Metodo getElementsByClassName()

Metodo querySelector()

Metodo querySelectorAll()

Manuale NodeList

Esempio

Esempio 1

Ottieni tutti gli elementi con nome "fname":

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

Prova da solo

Esempio 2

Restituisce il numero di elementi con name="animal":

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

Prova da solo

Esempio 3

Controlla tutti gli elementi <input> di tipo "checkbox" e nome "animal":

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

Prova da solo

Sintassi

document.getElementsByName(name)

Parametro

Parametro Descrizione
name Obbligatorio. Valore dell'attributo name dell'elemento.

Valore di ritorno

Tipo Descrizione
Oggetto

Oggetto NodeList.

Raccolta degli elementi con nome specificato.

Le elementi vengono ordinati secondo l'ordine di apparizione nel documento.

Supporto del browser

document.getElementsByName() È una caratteristica di DOM Level 1 (1998).

Tutti i browser lo supportano:

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