Os seus resultados da pesquisa

    document.getElementById()

    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 objeto Element, 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

    Veja também

    • referências de document para outros métodos e propriedades podem ser usados para obter referências para elementos no documento.
    • xml:id -  tem um método utilitário que permite que obtenha 'xml:id' em documentos XML

    Etiquetas do documento e colaboradores

     Colaboradores desta página: eustabio_junior, teoli, khalid32, willian, YgorFranca
     Última atualização por: eustabio_junior,