CKTIS / JavaScript
`Document.body` en `Document.title`: pagina-inhoud en titel
Met `document.body` vind je het element dat de pagina-inhoud bevat. Met `document.title` lees of wijzig je de tekst van de documenttitel.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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 is een afkorting voor twee eigenschappen van de interface Document; het is geen syntaxis voor in je code. In een paginascript is document het huidige documentobject. Beide eigenschappen zijn API’s van het webplatform en horen niet bij ECMAScript 2024. Een runtime zonder DOM hoeft document niet aan te bieden.
document.body geeft het eerste directe kind van het html-element terug dat een body of een verouderd frameset is. Als zo’n kind ontbreekt, krijg je null. Tijdens het parsen kan de body nog ontbreken. Controleer vóór gebruik of het element bestaat, of voer de code na het parsen uit, bijvoorbeeld in een handler voor DOMContentLoaded die je registreert voordat die gebeurtenis plaatsvindt.
Voeg inhoud toe met document.body.append(node) als je niet het hele element wilt vervangen. Wijs je een ander body- of frameset-element toe, dan vervang je het bestaande element inclusief zijn deelboom. Als er nog geen is, wordt het nieuwe element onder het hoofdelement van het document ingevoegd. Met null verwijder je de body niet: je krijgt een HierarchyRequestError. Die fout treedt ook op als het hoofdelement ontbreekt waaronder het nieuwe element moet worden ingevoegd.
document.title geeft een tekenreeks terug, geen element of h1-kop. Bij het lezen verdwijnt ASCII-witruimte aan het begin en einde en wordt elke interne reeks witruimte één spatie. Ontbreekt title in HTML, dan krijg je een lege tekenreeks. Een toewijzing wijzigt de titeltekst zonder die als HTML te verwerken en verandert meestal het tabbladlabel van een geopende pagina. Ontbreekt title maar bestaat head wel, dan wordt een title in head aangemaakt; ontbreken beide, dan doet de toewijzing niets. Een document met een SVG-svg als hoofdelement gebruikt een title in de SVG-naamruimte, direct onder dat hoofdelement.
Voorbeelden
<!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>Resultaat
Study notes Review the DOM.
Sla het voorbeeld op als `.html`-bestand, open het in een browser en bekijk de uitvoer in de console van de ontwikkelaarstools. Het script maakt een apart document, dus de inhoud en de tabbladtitel van de geopende pagina blijven ongewijzigd.
Gerelateerde lessen
- JavaScript · Les 36 · Gemiddeld · Versie: 3