Método getElementsByName() do Documento DOM HTML

Definição e uso

getElementsByName() O método retorna uma coleção de elementos com o nome especificado.

getElementsByName() O método retorna em tempo real NodeList.

NodeList

NodeList É uma coleção de nós semelhante a um array (lista).

Os nós na lista podem ser acessados por índice. O índice começa em 0.

length A propriedade retorna o número de nós na lista de retorno.

Por favor, consulte:

Método getElementById()

Método getElementsByTagName()

Método getElementsByClassName()

Método querySelector()

Método querySelectorAll()

Manual NodeList

Exemplo

Exemplo 1

Obtenha todos os elementos com nome "fname":

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

Experimente você mesmo

Exemplo 2

Retorna o número de elementos com name="animal":

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

Experimente você mesmo

Exemplo 3

Verifique todos os elementos <input> com type="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;
  }
}

Experimente você mesmo

Sintaxe

document.getElementsByName(name)

Parâmetro

Parâmetro Descrição
name Obrigatório. O valor da propriedade name do elemento.

Retorno

Tipo Descrição
Objeto

Objeto NodeList.

Conjunto de elementos com nome especificado.

Ordena de acordo com a ordem de aparecimento dos elementos no documento.

Suporte do navegador

document.getElementsByName() É uma característica do DOM Level 1 (1998).

Todos os navegadores suportam:

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