O métodogetElementsByName()
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.
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
.
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>
).
Ambos IE e Edge retorna um HTMLCollection
, e não um NodeList
Especificações
Epecificação | Status | Comentário |
---|---|---|
HTML Living Standard The definition of 'Document.getElementsByName()' in that specification. |
Padrão em tempo real | |
Document Object Model (DOM) Level 2 HTML Specification The definition of 'Document.getElementsByName()' in that specification. |
Obsoleto | Definição Inicial |
Compatibilidade com Nagevagores
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'