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