CKTIS / JavaScript
Verschil tussen `document.body` en `document.documentElement`
Gebruik `document.body` voor het element met de pagina-inhoud en `document.documentElement` voor het hoofdelement van het document. Beide eigenschappen kunnen `null` teruggeven.
Versie: Current web platform; runtime support varies
Syntax
document.body
document.documentElement
document.body = newBodydocument.documentElement geeft het hoofdelement van het document terug, of null als er geen is. Op een gewone HTML-pagina is dat <html>; in een XML-document kan het hoofdelement een andere naam hebben. De eigenschap is alleen-lezen, maar je kunt het teruggegeven element wel wijzigen, bijvoorbeeld door het attribuut lang in te stellen.
document.body geeft het eerste directe kind van het hoofdelement <html> terug dat een <body> of een verouderd <frameset> is. Alle drie de namen verwijzen naar elementen in de HTML-naamruimte. Als er geen passend kind is of als het hoofdelement geen HTML-element <html> is, is het resultaat null. Voeg op een gewone HTML-pagina de inhoud toe aan <body>, niet rechtstreeks aan <html>.
Als je een nieuw element aan document.body toewijst, vervang je de bestaande body met zijn hele deelboom in plaats van er inhoud aan toe te voegen. Als er geen body is, voegt de setter het opgegeven element toe aan het hoofdelement. Toewijzing van null of een ander element dan een HTML-<body> of HTML-<frameset>, of een invoegpoging zonder hoofdelement, leidt tot een DOMException met de naam HierarchyRequestError.
De HTML-standaard definieert document.body en de DOM-standaard definieert document.documentElement. Geen van beide eigenschappen maakt deel uit van ECMAScript 2024. Een omgeving zonder pagina-DOM biedt mogelijk geen globale document aan. Tijdens het parsen kan een script het hoofdelement al zien voordat <body> is gemaakt. Controleer vóór gebruik op null; op een gewone pagina kun je op DOMContentLoaded wachten als het parsen nog bezig is.
Voorbeelden
<!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>Resultaat
html > body true true true
Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de uitvoer in de browserconsole. Het script maakt een afzonderlijk HTML-document, toont de elementnamen en controleert de ouder-kindrelatie. Na het verwijderen van `<body>` geeft `doc.body` `null` terug en is het hoofdelement nog steeds hetzelfde object. De geopende pagina verandert niet.
Gerelateerde lessen
- JavaScript · Les 32 · Gemiddeld · Versie: 3