HTML DOM getElementsByName() Method

<Document Object

Mais "Try it Yourself" exemplos abaixo.

Definição e Uso

O getElementsByName() método devolve um conjunto de todos os elementos no documento com o nome especificado (the value of the name attribute) , como um objecto NodeList.

O objecto NodeList representa um conjunto de nodos. Os nódulos podem ser acedidos por números de índice. O índice começa em 0.

Dica: Você pode usar o comprimento propriedade do objeto NodeList para determinar o número de elementos com o nome especificado, então você pode percorrer todos os elementos e extrair a informação que deseja.

Nota: Em HTML5, o "name" atributo é obsoleto e foi substituído pelo "id" atributo para muitos elementos. Use o documento. getElementById() método em que é adequado. Também olhar para o getElementsByClassName() e getElementsByTagName() métodos.

Suporte navegador

Sintaxe

document.getElementsByName( Os valores dos parâmetros

Parâmetro	Tipo	Descrição
name	String	Requeridos. O name valor de atributo do elemento você deseja acessar / manipular

Detalhes técnicos

DOM Versão:	Núcleo Nível Objeto 1 Documento
Valor de retorno:	Um objecto NodeList, representando um conjunto de elementos com o nome especificado. Os elementos na coleção retornada são classificadas como eles aparecem no código-fonte.

---

mais Exemplos

Exemplo

Descubra quantos elementos existem no documento que tem um atributo de nome com o valor "animal" (usando a propriedade comprimento do objeto NodeList):

var x = document.getElementsByName("animal").length;

Tente você mesmo "

Exemplo

Verifique todos <input> elementos com type = "checkbox" no documento que tem um atributo de nome com o valor "animal" :

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

Tente você mesmo "

---

<Document Object