KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Node — een DOM-knooppunt

Node is de gedeelde interface voor DOM-knooppunten, waaronder elementen en tekst. Je kunt er boomrelaties mee onderzoeken, het type van een knooppunt uitlezen en de kinderen ervan wijzigen.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

node.contains(other)
node.firstChild
node.parentElement
node.insertBefore(newNode, referenceNode)
node.normalize()
node.parentNode
node.isConnected
node.nodeType
node.nodeValue
node.childNodes
Node.TEXT_NODE
Node.ELEMENT_NODE

Node staat voor een DOM-knooppunt, niet alleen voor een element. nodeType maakt onder andere onderscheid tussen Node.ELEMENT_NODE (1) en Node.TEXT_NODE (3). nodeValue geeft tekst- of commentaargegevens en attribuutwaarden weer, maar retourneert null voor een element; een waarde toewijzen aan een element heeft geen effect.

childNodes is een live NodeList van alle directe kinderen, inclusief witruimtetekst en opmerkingen. Wijzigingen in de boom werken de collectie bij. firstChild retourneert het eerste kind van welk type dan ook, of null. parentNode retourneert de ouder of null; parentElement retourneert die ouder alleen als het een element is, anders null.

contains(other) controleert of other hetzelfde knooppunt is of een afstammeling; voor null retourneert het false. De methode gaat niet over de grens van een shadow tree heen. isConnected geeft aan of het knooppunt verbonden is met een document, ook via een shadow tree, en niet of het op het scherm zichtbaar is.

insertBefore(newNode, referenceNode) retourneert newNode. Als newNode een DocumentFragment is, voegt de methode de kinderen van het fragment in plaats van het fragment zelf in en retourneert ze hetzelfde fragment, dat nu leeg is. Anders voegt ze newNode zelf in. De referentie moet een direct kind zijn; expliciet null betekent het einde van de lijst. Een bestaand knooppunt wordt verplaatst, niet gekopieerd. Een ongeldige ouder van de referentie veroorzaakt NotFoundError, en een niet-toegestane hiërarchie veroorzaakt HierarchyRequestError. normalize() verwijdert lege gewone Text-knooppunten in de subboom en voegt aangrenzende gewone Text-knooppunten samen. Daarbij blijft het eerste niet-lege knooppunt van elke samengevoegde reeks behouden. CDATASection-knooppunten worden niet verwijderd of samengevoegd, ook niet als ze leeg zijn; ze scheiden reeksen gewone Text-knooppunten. Witruimte in niet-lege tekst wordt niet verwijderd.

Voer het voorbeeld uit in een browser met een DOM. Het gebruik van Node 24 in een repository bewijst op zichzelf niet dat deze browser-API wordt ondersteund.

Referentie-identificatoren die in dit item worden behandeld: Node.contains, Node.firstChild, Node.parentElement, Node.insertBefore, Node.normalize, Node.parentNode, Node.isConnected, Node.nodeType, Node.nodeValue, Node.childNodes.

Voorbeelden

(() => {
  const root = document.createElement('div');
  const text = document.createTextNode('A');
  root.insertBefore(text, null);
  root.insertBefore(document.createTextNode('B'), null);
  const children = root.childNodes;

  console.log(children.length);
  console.log(root.nodeType === Node.ELEMENT_NODE);
  console.log(text.nodeType === Node.TEXT_NODE);
  console.log(text.parentNode === root, text.parentElement === root);
  console.log(root.contains(text), root.contains(root), root.contains(null));
  console.log(root.isConnected);

  root.normalize();
  console.log(children.length, root.firstChild.nodeValue);
  console.log(root.nodeValue === null);
})();

Resultaat

2
true
true
true true
true true false
false
1 AB
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen