CKTIS / JavaScript
Node — uzel DOM
Node je společné rozhraní pro uzly DOM, včetně elementů a textu. Umožňuje zkoumat vztahy ve stromu, číst typ uzlu a měnit jeho potomky.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
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 představuje uzel DOM, nejen element. nodeType rozlišuje mimo jiné Node.ELEMENT_NODE (1) a Node.TEXT_NODE (3). nodeValue zpřístupňuje textová či komentářová data a hodnoty atributů, ale pro element vrací null; přiřazení hodnoty elementu nic nezmění.
childNodes je živá kolekce NodeList všech přímých potomků, včetně textových uzlů obsahujících bílé znaky a komentářů. Změny stromu kolekci aktualizují. firstChild vrací prvního potomka libovolného typu, nebo null. parentNode vrací rodiče, nebo null; parentElement vrací tohoto rodiče pouze tehdy, jde-li o element, jinak vrací null.
contains(other) ověřuje, zda je other stejný uzel nebo jeho potomek; pro null vrací false. Nepřekračuje hranici stínového stromu. isConnected označuje připojení k dokumentu, a to i přes stínový strom, nikoli viditelnost na obrazovce.
insertBefore(newNode, referenceNode) vrací newNode. Pokud je newNode objekt typu DocumentFragment, metoda vloží jeho přímé potomky místo samotného fragmentu a vrátí tentýž, nyní prázdný fragment. Jinak vloží samotný newNode. Referenční uzel musí být přímým potomkem; explicitní null označuje konec seznamu. Existující uzel se přesune, nikoli zkopíruje. Neplatný rodič referenčního uzlu způsobí NotFoundError a nepovolená hierarchie způsobí HierarchyRequestError. normalize() odstraní prázdné běžné uzly Text v podstromu a sloučí sousední běžné uzly Text, přičemž v každé slučované posloupnosti zachová první neprázdný uzel. Uzly CDATASection neodstraňuje ani neslučuje, ani když jsou prázdné; tyto uzly oddělují posloupnosti běžných uzlů Text. Z neprázdného textu bílé znaky neodstraňuje.
Příklad spusťte v prohlížeči s DOM. Použití Node 24 v repozitáři samo o sobě nepotvrzuje podporu tohoto rozhraní prohlížeče.
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.
Pří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ýsledek
2 true true true true true true false false 1 AB true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.