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

CKTIS / JavaScript

`Document.body` e `Document.title`: conteúdo e título da página

`document.body` dá acesso ao elemento que contém o conteúdo da página, enquanto `document.title` permite ler ou alterar o texto do título.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

doc.body              // Read: HTMLBodyElement, HTMLFrameSetElement, or null
 doc.body = bodyElement // Write: supply an HTML body or frameset element
 doc.title             // Read: string
 doc.title = titleText // Write: supply title text

Document.body/title é uma forma abreviada de indicar duas propriedades da interface Document, não uma sintaxe para usar no código. Num script de uma página, document é o objeto que representa o documento atual. As duas propriedades pertencem às API da plataforma Web, não ao ECMAScript 2024. Um ambiente sem DOM não tem de disponibilizar document.

document.body devolve o primeiro filho direto do elemento html que seja um body ou um elemento obsoleto frameset. Se não houver nenhum, devolve null. Durante a análise do HTML, o corpo pode ainda não existir: verifica se existe antes de o utilizar ou executa o código após a análise, por exemplo num manipulador de DOMContentLoaded registado antes de o evento ser disparado.

Para acrescentar conteúdo sem substituir o elemento inteiro, usa document.body.append(node). Atribuir outro elemento body ou frameset substitui o elemento existente e a sua subárvore ou, se ainda não existir um desses elementos, insere o novo sob a raiz do documento. Atribuir null não remove o corpo: lança HierarchyRequestError. A exceção também é lançada se não houver uma raiz sob a qual inserir o novo elemento.

document.title devolve uma cadeia de caracteres, não um elemento nem um cabeçalho h1. Ao ler a propriedade, os caracteres de espaço em branco ASCII nas extremidades são removidos e cada sequência interna é reduzida a um único espaço. Em HTML, se faltar title, o resultado é a cadeia vazia. Uma atribuição altera o texto sem o interpretar como HTML e normalmente muda o rótulo do separador de uma página aberta. Se title estiver em falta mas existir head, a atribuição cria um title dentro de head; se faltarem ambos, não tem efeito. Num documento com um elemento SVG svg como raiz, é usado um title do espaço de nomes SVG que é filho direto dessa raiz.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document.body and Document.title example</title>
</head>
<body>
  <script>
    const doc = document.implementation.createHTMLDocument();
    doc.title = "  Study   notes  ";

    const paragraph = doc.createElement("p");
    paragraph.textContent = "Review the DOM.";
    doc.body.append(paragraph);

    console.log(doc.title);
    console.log(doc.body.textContent);
  </script>
</body>
</html>

Resultado

Study notes
Review the DOM.

Guarda o exemplo num ficheiro `.html`, abre-o num navegador e consulta a consola das ferramentas de desenvolvimento. O script cria um documento separado, pelo que não altera o conteúdo da página aberta nem o título do seu separador.

Lições relacionadas

  • JavaScript · Lição 36 · Intermédio · Versão: 3

Fontes