Document.getElementsByName()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
O método**getElementsByName()
** do objeto Document
retorna uma coleção de elementos NodeList
com um dado name
no documento.
Sintaxe
var elementos = document.getElementsByName(nome);
- elementos é uma coleção ativa de
NodeList
, significando que ele atualiza automaticamente com os novos elementos com o mesmonome
que são adicionados/removidos do documento. - nome é um valor do atributo
nome
dos elemento(s).
Exemplo
<!doctype html>
<html lang="en">
<title>Exemplo: usando document.getElementsByName</title>
<input type="hidden" name="up" />
<input type="hidden" name="down" />
<script>
var up_nomes = document.getElementsByName("up");
console.log(up_nomes[0].tagName); // exibindo o campo "INPUT"
</script>
</html>
Notas
O atributo name
pode somente ser aplicado nos documentos (X)HTML.
A coleção retornada NodeList
contém todos os elementos com o respectivo nome
, tal como <meta>
, <object>
, e até os elementos o qual não suporta o atributo nome
para todos.
Aviso:
O método getElementsByName trabalha diferentemente em IE10 e anteriores. Além de que, getElementsByName()
também retorna elementos que tem um atributo id
com o valor especificado. Seja cuidadoso para não usar a mesma string como ambos nome
e id
.
Aviso:
O método getElementsByName trabalha diferentemente no IE. Portanto, getElementsByName()
não retorna todos os elementos no qual não pode ter um atributo nome
(tal como <span>
).
Aviso:
Ambos IE e Edge retorna um HTMLCollection
, e não um NodeList
Especificações
Specification |
---|
HTML Standard # dom-document-getelementsbyname-dev |
Compatibilidade com navegadores
BCD tables only load in the browser
Veja também
document.getElementById()
para retornar uma referência para um elemento por um únicoid
document.getElementsByTagName()
para retornar referências para elementos com o mesmo nome tagdocument.querySelector()
para retornar referências para elementos via seletores CSS como'div.myclass'