Documento HTML DOM getElementsByName()
Exemplo
Obtenha todos os elementos com o nome "fname":
let collection = document.getElementsByName("fname");
Mais exemplos de "Experimente você mesmo" abaixo.
Definição e uso
O getElementsByName()método retorna uma coleção de elementos com um nome especificado.
O getElementsByName()método retorna um HTMLCollection .
Veja também:
O método document getElementById()
O método document getElementsByTagName()
O método document getElementsByClassName()
O método do documento querySelector()
Sintaxe
document.getElementsByName(name)
Parâmetros
| Parameter | Description |
| name | Required. The name value of the elements. |
Valor de retorno
| Modelo | Descrição |
| Objeto | Um objeto HTMLCollection . Uma coleção de elementos com o nome especificado. Os elementos são classificados conforme aparecem no documento. |
Mais exemplos
Número de elementos com name="animal":
let num = document.getElementsByName("animal").length;
Marque todos os elementos <input> com type="checkbox" que tenham o nome "animal":
const collection = document.getElementsByName("animal");
for (let i = 0; i < collection.length; i++) {
if (collection[i].type == "checkbox") {
collection[i].checked = true;
}
}
Suporte ao navegador
document.getElementsByName() é um recurso DOM Nível 1 (1998).
É totalmente suportado em todos os navegadores:
| Chrome | IE | Edge | Firefox | Safari | Opera |
| Yes | 9-11 | Yes | Yes | Yes | Yes |