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 janeiro de 2018.
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 mesmonomeque são adicionados/removidos do documento. - nome é um valor do atributo
nomedos 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 # dom-document-getelementsbyname-dev |
Compatibilidade com navegadores
Loading…
Veja também
document.getElementById()para retornar uma referência para um elemento por um únicoiddocument.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'