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_NODENode 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.