CKTIS / JavaScript
Node — DOM čvor
Node je zajedničko sučelje za DOM čvorove, uključujući elemente i tekst. Omogućuje provjeru odnosa u stablu, čitanje vrste čvora i mijenjanje njegovih potomaka.
Verzija: 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_NODENode predstavlja DOM čvor, a ne samo element. nodeType razlikuje, među ostalim, Node.ELEMENT_NODE (1) i Node.TEXT_NODE (3). nodeValue izlaže tekstualne podatke ili podatke komentara te vrijednosti atributa, ali za element vraća null; dodjela vrijednosti elementu nema učinka.
childNodes je živa kolekcija NodeList svih izravnih potomaka, uključujući tekstualne čvorove s bjelinama i komentare. Promjene stabla ažuriraju kolekciju. firstChild vraća prvog potomka bilo koje vrste ili null. parentNode vraća roditelja ili null; parentElement vraća tog roditelja samo ako je element, a u suprotnom vraća null.
contains(other) provjerava je li other isti čvor ili njegov potomak; za null vraća false. Ne prelazi granicu stabla sjene. isConnected označava povezanost s dokumentom, uključujući onu preko stabla sjene, a ne vidljivost na zaslonu.
insertBefore(newNode, referenceNode) vraća newNode. Ako je newNode objekt tipa DocumentFragment, metoda umeće njegove izravne potomke umjesto samog fragmenta i vraća isti fragment, koji je sada prazan. U suprotnom umeće sam newNode. Referenca mora biti izravan potomak; izričiti null znači kraj popisa. Postojeći čvor premješta se, a ne kopira. Nevaljan roditelj reference uzrokuje NotFoundError, a nedopuštena hijerarhija uzrokuje HierarchyRequestError. normalize() uklanja prazne obične čvorove Text u podstablu i spaja susjedne obične čvorove Text, zadržavajući prvi neprazni čvor u svakom spojenom nizu. Ne uklanja niti spaja čvorove CDATASection, čak ni kada su prazni; oni razdvajaju nizove običnih čvorova Text. Ne uklanja bjeline iz nepraznog teksta.
Primjer pokrenite u pregledniku s DOM-om. Upotreba Nodea 24 u repozitoriju sama po sebi ne potvrđuje podršku za ovaj API preglednika.
Referentni identifikatori obuhvaćeni ovim unosom: Node.contains, Node.firstChild, Node.parentElement, Node.insertBefore, Node.normalize, Node.parentNode, Node.isConnected, Node.nodeType, Node.nodeValue, Node.childNodes.
Primjeri
(() => {
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.