KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Zoeken op ID en het hoofdelement en de body opvragen

Gebruik `getElementById()` om een element op ID te vinden, `documentElement` voor het hoofdelement en `body` voor de HTML-body van het document. Alle drie kunnen om verschillende redenen `null` teruggeven.

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

Syntax

doc.getElementById(id) // id: string; returns Element or null
 doc.documentElement // read-only; returns Element or null
 doc.body // returns HTMLBodyElement, HTMLFrameSetElement, or null
 doc.body = newBody // assigns an HTML body or frameset element

doc.getElementById(id) zoekt in de boom van document doc. Geef de exacte id-waarde op zonder een # ervoor te zetten: het is geen CSS-selector en hoofdletters en kleine letters maken uit. De methode geeft een passend Element of null terug. ID’s horen uniek te zijn; bij duplicaten telt de eerste treffer in boomvolgorde. Losstaande knopen en bomen binnen het Shadow DOM worden niet doorzocht.

doc.documentElement is alleen-lezen: het geeft het hoofdelement terug (<html> in een HTML-document; in XML kan dat een ander element zijn), of null als er geen hoofdelement is. doc.body geeft het eerste directe kind van <html> terug dat een <body> of een verouderd <frameset> is, of null als zo’n kind ontbreekt. Lees beide eigenschappen zonder haakjes.

In tegenstelling tot documentElement kun je aan body een waarde toekennen om het bestaande element te vervangen. De kinderen ervan worden niet naar het nieuwe element verplaatst. Als je null of een HTMLElement toekent dat geen <body> of <frameset> is, wordt HierarchyRequestError gegenereerd. Als het element HTMLElement niet implementeert, zoals bij een SVG-element, veroorzaakt de Web IDL-conversie een TypeError voordat de setter wordt aangeroepen. Ook bij het toekennen van een geldig <body>- of <frameset>-element treedt HierarchyRequestError op als het document geen hoofdelement heeft.

Tijdens het parsen bestaat de body of het gezochte element mogelijk nog niet. Als je code afhankelijk is van de opmaakcode van de pagina, wacht dan op DOMContentLoaded wanneer document.readyState === "loading"; voer de code anders meteen uit. Controleer vóór gebruik op null: rechtstreeks een eigenschap van null lezen veroorzaakt een TypeError. Deze API’s zijn gedefinieerd in de DOM- en HTML-standaarden, niet in ECMAScript. De versieaanduiding ECMAScript 2024 zegt niets over hun beschikbaarheid. Ga er niet van uit dat elke JavaScript-omgeving document aanbiedt.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document lookup demo</title>
</head>
<body>
  <script>
    const doc = document.implementation.createHTMLDocument("Demo");
    const panel = doc.createElement("section");
    panel.id = "Panel";

    console.log(doc.documentElement.localName);
    console.log(doc.body.localName);
    console.log(doc.getElementById("Panel"));

    doc.body.appendChild(panel);
    console.log(doc.getElementById("Panel") === panel);
    console.log(doc.getElementById("panel"));
  </script>
</body>
</html>

Resultaat

html
body
null
true
null

Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de ontwikkelaarsconsole. Het aparte HTML-document bevat al `html` en `body` en wijzigt de pagina niet waarop het script draait. `Panel` wordt pas na het invoegen gevonden; `panel` komt niet overeen vanwege het verschil in hoofdlettergebruik.

Gerelateerde lessen

  • JavaScript · Les 37 · Gevorderd · Versie: 4

Bronnen