KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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 text

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

Bronnen