Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Node — uzol DOM

Node je spoločné rozhranie pre uzly DOM vrátane elementov a textu. Umožňuje skúmať vzťahy v strome, čítať typ uzla a meniť jeho potomkov.

Verzia: 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 predstavuje uzol DOM, nielen element. nodeType rozlišuje okrem iného Node.ELEMENT_NODE (1) a Node.TEXT_NODE (3). nodeValue sprístupňuje textové alebo komentárové údaje a hodnoty atribútov, ale pre element vracia null; priradenie hodnoty elementu nič nezmení.

childNodes je živá kolekcia NodeList všetkých priamych potomkov vrátane textových uzlov obsahujúcich biele znaky a komentárov. Zmeny stromu kolekciu aktualizujú. firstChild vracia prvého potomka ľubovoľného typu alebo null. parentNode vracia rodiča alebo null; parentElement vracia tohto rodiča iba vtedy, ak je elementom, inak vracia null.

contains(other) kontroluje, či je other ten istý uzol alebo jeho potomok; pre null vracia false. Neprechádza cez hranicu tieňového stromu. isConnected označuje spojenie s dokumentom, aj cez tieňový strom, nie viditeľnosť na obrazovke.

insertBefore(newNode, referenceNode) vracia newNode. Ak je newNode objekt typu DocumentFragment, metóda vloží jeho priamych potomkov namiesto samotného fragmentu a vráti ten istý, už prázdny fragment. Inak vloží samotný newNode. Referenčný uzol musí byť priamym potomkom; explicitné null znamená koniec zoznamu. Existujúci uzol sa presunie, nie skopíruje. Neplatný rodič referenčného uzla spôsobí NotFoundError a nepovolená hierarchia spôsobí HierarchyRequestError. normalize() odstráni prázdne bežné uzly Text v podstrome a spojí susediace bežné uzly Text, pričom v každej spájanej postupnosti zachová prvý neprázdny uzol. Uzly CDATASection neodstraňuje ani nespája, a to ani vtedy, keď sú prázdne; tieto uzly oddeľujú postupnosti bežných uzlov Text. Z neprázdneho textu neodstraňuje biele znaky.

Príklad spustite v prehliadači s DOM. Použitie Node 24 v repozitári samo osebe nepotvrdzuje podporu tohto rozhrania prehliadača.

Referenčné identifikátory zahrnuté v tomto hesle: Node.contains, Node.firstChild, Node.parentElement, Node.insertBefore, Node.normalize, Node.parentNode, Node.isConnected, Node.nodeType, Node.nodeValue, Node.childNodes.

Príklady

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

Výsledok

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

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje