CKTIS / JavaScript
Document.getElementById() e documentElement: pesquisa por ID e elemento raiz
`getElementById()` procura um elemento pelo seu ID exato, enquanto `documentElement` dá acesso ao elemento raiz do documento. Ambos podem devolver `null`, mas por motivos diferentes.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
doc.getElementById(id) // Element or null
doc.documentElement // Element or null; read-onlydoc.getElementById(id) pesquisa na árvore atual de doc. Passa o próprio ID, por exemplo 'Panel', sem acrescentar o prefixo # de um seletor CSS. A pesquisa distingue maiúsculas de minúsculas e devolve um Element ou null se não houver correspondência. Em HTML, os ID têm de ser únicos na respetiva árvore. Se houver duplicados, o método devolve a primeira correspondência na ordem da árvore.
A pesquisa não abrange elementos que não estejam inseridos nessa árvore nem elementos no interior de árvores de shadow DOM. Se o código for executado antes da inserção, o resultado pode ser null; verifica-o antes de aceder a uma propriedade. Uma chamada posterior repete a pesquisa, mas uma referência guardada não muda quando o elemento é removido.
doc.documentElement é uma propriedade só de leitura, não um método. Devolve o elemento raiz independentemente do seu ID: html num documento HTML típico, ou o elemento que for a raiz em XML. Não é o próprio nó Document nem body. Se não houver elemento raiz, o valor é null.
Ambos os membros fazem parte da API DOM da Web, não de ECMAScript 2024. O suporte de JavaScript, por si só, não garante a disponibilidade de document.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Document ID lookup and root element</title>
</head>
<body>
<script>
(() => {
const doc = document.implementation.createHTMLDocument('Demo');
const panel = doc.createElement('div');
panel.id = 'Panel';
console.log(doc.documentElement.localName);
console.log(doc.getElementById('Panel'));
doc.body.appendChild(panel);
console.log(doc.getElementById('Panel') === panel);
console.log(doc.getElementById('panel'));
console.log(new Document().documentElement);
})();
</script>
</body>
</html>Resultado
html null true null null
Guarda o exemplo como ficheiro `.html`, abre-o num navegador e verifica os resultados na consola de programador. O exemplo cria um documento HTML separado e não altera a página atual. `'Panel'` só é encontrado depois da inserção, `'panel'` não corresponde e um novo `Document` vazio não tem elemento raiz.
Lições relacionadas
- JavaScript · Lição 19 · Avançado · Versão: 4
- JavaScript · Lição 33 · Avançado · Versão: 4