Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Node — vozlišče DOM

Node je skupni vmesnik za vozlišča DOM, vključno z elementi in besedilom. Omogoča preverjanje odnosov v drevesu, branje vrste vozlišča in spreminjanje njegovih otrok.

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

Sintaksa

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 predstavlja vozlišče DOM, ne le elementa. nodeType med drugim razlikuje med Node.ELEMENT_NODE (1) in Node.TEXT_NODE (3). nodeValue razkriva besedilne podatke ali podatke komentarja ter vrednosti atributov, za element pa vrne null; prirejanje vrednosti elementu nima učinka.

childNodes je živa zbirka NodeList vseh neposrednih otrok, vključno z besedilnimi vozlišči, ki vsebujejo presledke, in komentarji. Spremembe drevesa posodobijo zbirko. firstChild vrne prvega otroka poljubne vrste ali null. parentNode vrne nadrejeno vozlišče ali null; parentElement ga vrne le, če je element, sicer vrne null.

contains(other) preveri, ali je other isto vozlišče ali njegov potomec; za null vrne false. Ne prečka meje senčnega drevesa. isConnected označuje povezavo z dokumentom, tudi prek senčnega drevesa, ne pa vidnosti na zaslonu.

insertBefore(newNode, referenceNode) vrne newNode. Če je newNode objekt DocumentFragment, metoda vstavi njegove otroke namesto samega fragmenta in vrne isti, zdaj prazen fragment. Sicer vstavi sam newNode. Referenca mora biti neposreden otrok; izrecni null pomeni konec seznama. Obstoječe vozlišče se premakne, ne kopira. Neveljaven nadrejeni element reference povzroči NotFoundError, nedovoljena hierarhija pa HierarchyRequestError. normalize() odstrani prazna navadna vozlišča Text v poddrevesu in združi sosednja navadna vozlišča Text, pri čemer v vsakem združenem zaporedju ohrani prvo neprazno vozlišče. Vozlišč CDATASection ne odstranjuje in ne združuje, tudi če so prazna; ta vozlišča ločujejo zaporedja navadnih vozlišč Text. Belih znakov v nepraznem besedilu ne odstrani.

Primer zaženite v brskalniku z DOM. Uporaba Node 24 v repozitoriju sama po sebi ne potrjuje podpore za ta API brskalnika.

Referenčni identifikatorji, zajeti v tem geslu: Node.contains, Node.firstChild, Node.parentElement, Node.insertBefore, Node.normalize, Node.parentNode, Node.isConnected, Node.nodeType, Node.nodeValue, Node.childNodes.

Primeri

(() => {
  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);
})();

Rezultat

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri