KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Document.getElementById() en documentElement: zoeken op ID of het hoofdelement opvragen

`getElementById()` zoekt een element op zijn exacte ID. `documentElement` geeft het hoofdelement van het document. Beide kunnen `null` opleveren, maar om verschillende redenen.

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

Syntax

doc.getElementById(id) // Element or null
doc.documentElement    // Element or null; read-only

doc.getElementById(id) doorzoekt de huidige boom van doc. Geef de ID zelf door, bijvoorbeeld 'Panel', zonder het voorvoegsel # van een CSS-selector toe te voegen. De zoekactie is hoofdlettergevoelig en geeft een Element terug, of null als er geen overeenkomst is. HTML-ID’s moeten uniek zijn binnen hun boom. Bij dubbele ID’s krijg je de eerste overeenkomst in boomvolgorde.

De methode doorzoekt geen elementen die niet in die boom zijn ingevoegd en geen elementen binnen shadowbomen. Als je script vóór het invoegen draait, kan het resultaat null zijn. Controleer het voordat je een eigenschap ervan leest. Een volgende aanroep zoekt opnieuw, maar een opgeslagen verwijzing verandert niet als het element wordt verwijderd.

doc.documentElement is een alleen-lezen eigenschap, geen methode. Die geeft het hoofdelement terug ongeacht zijn ID: html in een typisch HTML-document, of het element dat als wortel dient in XML. Dat is niet de Document-node zelf en ook niet body. Zonder hoofdelement is de waarde null.

Beide behoren tot de DOM-API van het web, niet tot ECMAScript 2024. Ondersteuning voor JavaScript alleen garandeert niet dat document beschikbaar is.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document ID lookup and root element</title>
</head>
<body>
  <script>
    (() => {
      const doc = document.implementation.createHTMLDocument('Demo');
      const panel = doc.createElement('div');
      panel.id = 'Panel';

      console.log(doc.documentElement.localName);
      console.log(doc.getElementById('Panel'));
      doc.body.appendChild(panel);
      console.log(doc.getElementById('Panel') === panel);
      console.log(doc.getElementById('panel'));
      console.log(new Document().documentElement);
    })();
  </script>
</body>
</html>

Resultaat

html
null
true
null
null

Sla het voorbeeld op als `.html`-bestand, open het in een browser en bekijk de uitvoer in de browserconsole. Het voorbeeld maakt een apart HTML-document aan en verandert de huidige pagina niet. `'Panel'` wordt pas na het invoegen gevonden, `'panel'` komt niet overeen en een nieuw leeg `Document` heeft geen hoofdelement.

Gerelateerde lessen

  • JavaScript · Les 19 · Gevorderd · Versie: 4
  • JavaScript · Les 33 · Gevorderd · Versie: 4

Bronnen