CKTIS / JavaScript
Documento DOM: pesquisa por ID, elemento raiz e título
Encontra um elemento pelo seu ID exato, acede ao elemento raiz e lê ou altera o título do documento. Distingue um nó inexistente de uma cadeia vazia.
Versão: Current web platform; runtime support varies
Sintaxe
document.getElementById(id)
document.documentElement
document.title
document.title = valuedocument.getElementById(id) procura na árvore do documento um elemento cujo id corresponda exatamente ao valor indicado, distinguindo maiúsculas de minúsculas. Passa o ID sem acrescentar #: o argumento não é um seletor CSS. O método devolve um Element ou null; verifica o resultado antes de aceder às propriedades do elemento. Os ID devem ser únicos na árvore. Se houver duplicados, o método devolve a primeira correspondência pela ordem da árvore.
A pesquisa usa a árvore tal como está no momento da chamada. Não encontra elementos que ainda não foram inseridos no documento nem elementos numa árvore shadow separada. document.documentElement é uma propriedade só de leitura que devolve o elemento raiz, normalmente html num documento HTML, ou null se não houver raiz. Não é document.body.
document.title é uma propriedade de leitura e escrita cujo valor é uma cadeia de caracteres. Não é o nó title, o atributo title de um elemento nem um cabeçalho visível. Num documento HTML típico, a leitura remove os caracteres de espaço em branco ASCII das extremidades e reduz cada sequência interna a um único espaço. Sem um elemento title, devolve "". A atribuição substitui o conteúdo do título por texto, não por marcação HTML. Se faltar title, cria-o em head caso exista; caso contrário, não produz efeito. Se a raiz for um svg no espaço de nomes SVG, a atribuição atualiza ou cria um filho direto title nesse espaço de nomes, a partir do qual se lê o título.
As normas DOM e HTML definem estas API da plataforma Web. A sua utilização não requer ECMAScript 2024. Quando o documento é apresentado num separador do navegador, o título costuma aparecer no separador. Um ambiente sem DOM não tem de disponibilizar document.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOM document example</title>
</head>
<body>
<script>
{
const doc = document.implementation.createHTMLDocument("Draft");
const item = doc.createElement("p");
item.id = "status";
console.log(doc.title);
console.log(doc.getElementById("status") === null);
doc.body.append(item);
console.log(doc.getElementById("status") === item);
console.log(doc.getElementById("Status") === null);
console.log(doc.documentElement.localName);
doc.title = " Ready to publish ";
console.log(doc.title);
}
</script>
</body>
</html>Resultado
Draft true true true html Ready to publish
Guarda o exemplo completo num ficheiro HTML, abre-o no navegador e consulta a consola das ferramentas de desenvolvimento. O exemplo cria um documento HTML separado, sem alterar a página atual nem o título do separador. Os três valores `true` mostram, pela ordem, que não há correspondência antes da inserção, que se obtém o mesmo objeto após a inserção e que se distinguem maiúsculas de minúsculas.
Lições relacionadas
- JavaScript · Lição 38 · Avançado · Versão: 4