KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

`document.getElementById()` tegenover `document.body`

Gebruik `getElementById()` om een element op ID te zoeken en `document.body` om het body-element van het document op te halen, met of zonder ID.

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

Syntax

document.getElementById(id)
document.body
document.body = newBody

document.getElementById(id) doorzoekt de boom van dat document en geeft een Element of null terug. Geef de exacte waarde van id mee, bijvoorbeeld "note", niet een CSS-selector zoals "#note". De zoekopdracht is hoofdlettergevoelig. ID’s horen uniek te zijn; bij duplicaten krijg je de eerste overeenkomst in boomvolgorde. Elementen die nog niet in de documentboom zijn ingevoegd, worden niet gevonden.

Lees document.body zonder haakjes. De eigenschap geeft het eerste rechtstreekse kind van het HTML-hoofdelement html terug dat een HTML-element body of een verouderd HTML-element frameset is, of null als dat er niet is. document.getElementById("body") zoekt de ID body, niet de tag, en kan een ander element of null teruggeven terwijl document.body wel bestaat.

Een toewijzing aan document.body kan het bestaande body-knooppunt met zijn volledige deelboom vervangen. Als er nog geen body is, wordt het nieuwe element aan het hoofdelement van het document toegevoegd. Bij toewijzing van null of een ander element dan een HTML-element body of frameset, of wanneer het document geen hoofdelement heeft, krijg je een DOMException met de naam HierarchyRequestError.

Tijdens het parsen kan null betekenen dat het knooppunt nog niet is gemaakt. Benader het bij statische HTML na het parsen, bijvoorbeeld in een DOMContentLoaded-handler die vóór de gebeurtenis is geregistreerd, en controleer altijd het resultaat vóór gebruik. Dit zijn webplatform-API’s, geen onderdeel van ECMAScript 2024; een gewone webworker heeft geen toegang tot het document van de pagina.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>DOM lookup example</title>
</head>
<body>
  <script>
    (() => {
      const doc = document.implementation.createHTMLDocument("DOM demo");
      const body = doc.body;
      console.log(`Before setting an ID: ${doc.getElementById("body")}`);

      body.id = "body";
      console.log(`Same node: ${doc.getElementById("body") === body}`);
      console.log(`Wrong case: ${doc.getElementById("Body")}`);

      const item = doc.createElement("p");
      item.id = "note";
      console.log(`Before insertion: ${doc.getElementById("note")}`);
      body.appendChild(item);
      console.log(`After insertion: ${doc.getElementById("note") === item}`);
    })();
  </script>
</body>
</html>

Resultaat

Before setting an ID: null
Same node: true
Wrong case: null
Before insertion: null
After insertion: true

Sla het voorbeeld op als `.html`-bestand, open het in een browser en controleer de berichten in de browserconsole. Het aparte document heeft al een `body`-element, maar nog geen ID. Na het toekennen van een ID geven beide vormen van toegang hetzelfde knooppunt terug. Het `p`-element wordt pas na invoeging gevonden.

Gerelateerde lessen

  • JavaScript · Les 6 · Gevorderd · Versie: 4

Bronnen