KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

DOM-navigatie: kinderen, tagnaam, ouder en zusterelementen

Lees de tagnaam en navigeer tussen directe kinderen, de ouder en naburige elementen. Leer wanneer een verzameling automatisch wordt bijgewerkt en wanneer een eigenschap `null` kan opleveren.

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

Syntax

element.children                // HTMLCollection
element.tagName                 // string
element.parentElement           // Element or null
element.previousElementSibling  // Element or null
element.nextElementSibling      // Element or null

Deze vijf DOM-eigenschappen zijn alleen-lezen. Je leest ze met puntnotatie, zonder aanroephaakjes. Ze horen bij de DOM-API, niet bij ECMAScript 2024; een uitvoeromgeving zonder DOM biedt ze niet aan.

element.children is een live HTMLCollection van directe kindelementen in DOM-volgorde. Zonder kindelementen is de collectie leeg. element.childNodes is ook live, maar is een NodeList van alle directe kindknopen, waaronder tekst en commentaar. Een opgeslagen children-collectie wordt bijgewerkt als de DOM verandert. Array.from(element.children) legt de huidige elementreferenties en hun volgorde vast in een array, zonder de elementen te klonen.

element.tagName geeft de gekwalificeerde tagnaam terug als tekenreeks, inclusief een eventueel voorvoegsel. Bij een element in de HTML-naamruimte in een HTML-document worden ASCII-letters hoofdletters, zoals in "DIV". Anders blijven hoofdletters en kleine letters behouden, ook bij SVG in een HTML-document en XHTML dat als XML wordt verwerkt. Gebruik localName samen met namespaceURI als de naamruimte meetelt bij een vergelijking.

element.parentElement komt van Node. De eigenschap geeft de directe ouder terug als die een element is, of null als er geen ouder is of als de ouder geen element is. Bij het hoofdelement van een document is parentElement bijvoorbeeld null, terwijl parentNode het Document teruggeeft.

previousElementSibling en nextElementSibling geven respectievelijk het dichtstbijzijnde element vóór of na het huidige element onder dezelfde ouder, of null als er geen is. Ze slaan tekst en commentaar over, anders dan previousSibling en nextSibling, die ook zulke knopen kunnen teruggeven. Controleer op null voordat je tagName leest, of gebruik element.nextElementSibling?.tagName, dat undefined oplevert als er geen volgend zusterelement is.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>DOM element traversal</title>
</head>
<body>
<script>
{
  const doc = document.implementation.createHTMLDocument();
  const box = doc.createElement('div');
  const first = doc.createElement('span');
  const second = doc.createElement('em');
  box.append(first, ' ', doc.createComment('gap'), second);

  const live = box.children;
  const snapshot = Array.from(live);
  console.log(JSON.stringify([live.length, box.childNodes.length, live[0].tagName]));
  console.log(JSON.stringify([
    first.parentElement?.tagName,
    first.nextElementSibling?.tagName,
    second.previousElementSibling?.tagName,
    first.previousElementSibling,
    second.nextElementSibling
  ]));

  box.append(doc.createElement('strong'));
  console.log(JSON.stringify([
    live.length, snapshot.length,
    doc.documentElement.parentElement,
    doc.documentElement.parentNode === doc
  ]));
}
</script>
</body>
</html>

Resultaat

[2,4,"SPAN"]
["DIV","EM","SPAN",null,null]
[3,2,null,true]

Sla het voorbeeld op als `.html`-bestand, open het in een browser en bekijk de uitvoer in de browserconsole. Het voorbeeld gebruikt een apart HTML-document en wijzigt de geopende pagina niet. De spatie en het commentaar tellen mee in `childNodes`, maar niet in `children`. Na het toevoegen van een element neemt alleen de lengte van de live collectie toe.

Gerelateerde lessen

  • JavaScript · Les 34 · Gemiddeld · Versie: 3

Bronnen