Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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 = value

document.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

Fontes