Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
document.getElementById()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.
Sumário
Retorna a referência do elemento através do seu ID.
Sintaxe
var elemento = document.getElementById(id);
onde
elementoé uma referência a um objetoElement, ou null se um elemento com o ID especificado não estiver contido neste documento.idé uma string que diferência maiúsculas e minúsculas representando o ID único do elemento sendo procurado.
Exemplo
<!doctype html><html> <head> <title>Exemplo getElementById</title> <script> function mudarCor(novaCor) { var elemento = document.getElementById("para1"); elemento.style.color = novaCor; } </script> </head> <body> <p>Algum texto de exemplo</p> <button>Azul</button> <button>Vermelho</button> </body></html>Notas
Os novatos devem notar que a caixa de 'Id' no nome deste métododeve estar correta para o código da função - 'getElementByIDnão funciona, por mais natural que possa parecer.
Se não existe um elemento com o id fornecido, esta função retornanull. Note que o parâmetro ID diferência maiúsculas e minúsculas. Assim document.getElementById("Main") retornaránull ao invés do elemento<div>, devido a "M" e "m" serem diferentes para o objetivo deste método.
Elementos que não estão no documento não são procurados porgetElementById. Quando criar um elemento e atribuir um ID ao mesmo, você deve inserir o elemento na árvore do documento cominsertBefore ou método similar antes que você possa acessá-lo comgetElementById:
var elemento = document.createElement("div");elemento.id = "testqq";var el = document.getElementById("testqq"); // el será null!Documentos não-HTML. A implementação do DOM deve ter informações que diz quais atributos são do tipo ID. Atributos com o nome "id" não são do tipo ID a menos que assim sejam definidos nos documentos DTD. O atributoid é definido para ser um tipo ID em casos comuns deXHTML,XUL, e outros. Implementações que não reconhecem se os atributos são do tipo ID, ou não são esperados retornamnull.
Especificações
| Specification |
|---|
| DOM # ref-for-dom-nonelementparentnode-getelementbyid② |