Esta tradução está incompleta. Ajude atraduzir este artigo.
Sumário
Retorna a referência do elemento através do seu ID.
Sintaxe
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>getElementById example</title>
<script>
function changeColor(newColor) {
var elem = document.getElementById("para1");
elem.style.color = newColor;
}
</script>
</head>
<body>
<p id="para1">Some text here</p>
<button onclick="changeColor('blue');">blue</button>
<button onclick="changeColor('red');">red</button>
</body>
</html>
Notas
Os novatos devem notar que a caixa de 'Id' no nome deste método deve estar correta para o código da função - 'getElementByID não funciona, por mais natural que possa parecer.
Se não existe um elemento com o id fornecido, esta função retorna null. Note que o parâmetro ID diferência maiúsculas e minúsculas. Assim document.getElementById("Main") retornará null envez do elemento <div id="main">, 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 por getElementById. Quando criar um elemento e atribuir um ID ao mesmo, você deve inserir o elemento na árvore do documento com insertBefore ou método similar antes que você possa acessá-lo com getElementById:
var element = document.createElement("div");
element.id = 'testqq';
var el = document.getElementById('testqq'); // el will be 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 atributo id é definido para ser um tipo ID em casos comuns de XHTML, XUL, e outros. Implementações que não reconhecem se os atributos são do tipo ID, ou não são esperados retornam null.
Compatibilidade do Navegador
| Recurso | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Suporte básico | 1.0 | 1.0 (1.7 or earlier) | 5.5 | 7.0 | 1.0 |
| Recurso | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Suporte básico | 1.0 | 1.0 (1.0) | 6.0 | 6.0 | 1.0 |
Especificações
getElementById foi introduzido no DOM Level 1 para documentos HTML e movidos para todos documentos no DOM Level 2
- Especificação núcleo DOM Level 2: getElementById