Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

`Document.body` e `Document.title`: contenuto e titolo della pagina

`document.body` dà accesso all’elemento che contiene il contenuto della pagina, mentre `document.title` permette di leggere o modificare il testo del titolo.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

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 è un modo abbreviato per indicare due proprietà dell’interfaccia Document, non una sintassi da usare nel codice. In uno script della pagina, document è l’oggetto che rappresenta il documento corrente. Le due proprietà fanno parte delle API della piattaforma web, non di ECMAScript 2024. Un ambiente senza DOM non è tenuto a fornire document.

document.body restituisce il primo figlio diretto dell’elemento html che sia un body o un elemento obsoleto frameset. Se non ne trova uno, restituisce null. Durante l’analisi di HTML il corpo potrebbe non esistere ancora: controlla che sia presente prima di usarlo, oppure esegui il codice dopo l’analisi, per esempio in un gestore di DOMContentLoaded registrato prima che scatti l’evento.

Per aggiungere contenuto senza sostituire l’intero elemento, usa document.body.append(node). Assegnare un altro elemento body o frameset sostituisce quello esistente e il suo sottoalbero oppure, se non ce n’è ancora uno, inserisce il nuovo elemento sotto la radice del documento. Assegnare null non rimuove il corpo: genera HierarchyRequestError. L’eccezione si verifica anche se manca una radice sotto cui inserire il nuovo elemento.

document.title restituisce una stringa, non un elemento né un’intestazione h1. In lettura, elimina i caratteri di spaziatura ASCII alle estremità e riduce le sequenze interne a singoli spazi. In HTML, se manca title, restituisce la stringa vuota. L’assegnazione modifica il testo del titolo senza interpretarlo come HTML e in genere cambia l’etichetta della scheda di una pagina aperta. Se manca title ma esiste head, crea un title in head; se mancano entrambi, non ha effetto. Un documento con un elemento SVG svg come radice usa un title nello spazio dei nomi SVG che è figlio diretto della radice.

Esempi

<!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>

Risultato

Study notes
Review the DOM.

Salva l’esempio come file `.html`, aprilo in un browser e controlla l’output nella console degli strumenti per sviluppatori. Lo script crea un documento separato, quindi non modifica il contenuto della pagina aperta né il titolo della sua scheda.

Lezioni correlate

  • JavaScript · Lezione 36 · Intermedio · Versione: 3

Fonti