CKTIS / JavaScript
Differenza tra `document.body` e `document.documentElement`
Usa `document.body` per accedere all’elemento che contiene il contenuto della pagina e `document.documentElement` per accedere all’elemento radice del documento. Entrambe le proprietà possono restituire `null`.
Versione: Current web platform; runtime support varies
Sintassi
document.body
document.documentElement
document.body = newBodydocument.documentElement restituisce l’elemento radice del documento, oppure null se non esiste. In una normale pagina HTML è <html>; in un documento XML la radice può avere un altro nome. La proprietà è di sola lettura, ma puoi modificare l’elemento restituito, per esempio impostandone l’attributo lang.
document.body restituisce il primo figlio diretto della radice <html> che sia un <body> o un <frameset> obsoleto. Tutti e tre i nomi indicano elementi dello spazio dei nomi HTML. Se non c’è un figlio corrispondente o se la radice non è un elemento HTML <html>, restituisce null. In una normale pagina HTML, aggiungi i contenuti a <body>, non direttamente a <html>.
Assegnare un nuovo elemento a document.body sostituisce il corpo esistente e il suo sottoalbero, anziché aggiungervi contenuti. Se il corpo manca, il setter aggiunge l’elemento fornito alla radice. Assegnare null o un elemento diverso da un <body> o un <frameset> HTML, oppure tentare un inserimento senza radice, genera una DOMException di nome HierarchyRequestError.
Lo standard HTML definisce document.body, mentre lo standard DOM definisce document.documentElement. Nessuna delle due proprietà fa parte di ECMAScript 2024. Un ambiente senza il DOM di una pagina potrebbe non fornire il globale document. Durante l’analisi dell’HTML, uno script può vedere la radice prima che venga creato <body>. Prima di usare il risultato, verifica che non sia null; su una pagina normale, se l’analisi è ancora in corso, puoi attendere DOMContentLoaded.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Document body and root</title>
</head>
<body>
<script>
{
const doc = document.implementation.createHTMLDocument();
const root = doc.documentElement;
const body = doc.body;
console.log(`${root.localName} > ${body.localName}`);
console.log(body.parentElement === root);
body.remove();
console.log(doc.body === null);
console.log(doc.documentElement === root);
}
</script>
</body>
</html>Risultato
html > body true true true
Salva l’esempio come file HTML, aprilo in un browser e controlla la console. Lo script crea un documento HTML separato, mostra i nomi degli elementi e verifica la relazione genitore-figlio. Dopo la rimozione di `<body>`, `doc.body` restituisce `null` e la radice è ancora lo stesso oggetto. La pagina aperta rimane invariata.
Lezioni correlate
- JavaScript · Lezione 32 · Intermedio · Versione: 3