CKTIS / JavaScript
Zisťovanie vzťahov a úprava uzlov DOM pomocou `Node`
Over, či uzol patrí do podstromu, zisti jeho rodiča alebo prvého potomka, vlož uzol na konkrétne miesto a zlúč susediace textové uzly.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
node.contains(otherNode)
node.normalize()
node.parentNode
node.firstChild
parent.insertBefore(newNode, referenceNode)
parent.insertBefore(newNode, null)Node je rozhranie webového DOM, nie súčasť ECMAScriptu 2024. Tieto metódy a vlastnosti sa používajú na objektoch uzlov. V prehliadači príklad používa natívny DOM, v Node.js zjednodušený model použitých elementov a textových uzlov.
node.contains(otherNode) vráti true, ak je otherNode ten istý uzol alebo jeho potomok v ľubovoľnej hĺbke. Pre null vráti false. Test zostáva v rámci toho istého stromu uzlov: funguje aj v odpojenom podstrome a neprechádza z hostiteľa do jeho stromu shadow DOM.
parentNode a firstChild sú vlastnosti iba na čítanie. Prvá vráti priameho rodiča alebo null; na rozdiel od parentElement môže vrátiť aj Document alebo DocumentFragment. Druhá vráti prvého priameho potomka alebo null. Tento potomok môže byť komentár alebo textový uzol s bielymi znakmi. Na získanie prvého priameho potomka, ktorý je elementom, použi firstElementChild.
parent.insertBefore(newNode, referenceNode) vloží uzol pred určeného priameho potomka. Druhý argument odovzdaj výslovne: null znamená vloženie na koniec. Pomocou parent.firstChild teda vložíš uzol na začiatok aj vtedy, keď je rodič prázdny. Metóda existujúci uzol presunie namiesto kopírovania a vráti newNode. Ak dostane DocumentFragment, presunie jeho priame potomky a vráti vyprázdnený fragment. Ak referenčný uzol nie je priamym potomkom, vyvolá NotFoundError; neplatná hierarchia, napríklad cyklus, vyvolá HierarchyRequestError.
node.normalize() upraví priamo podstrom: odstráni prázdne bežné textové uzly a zlúči susediace uzly tohto typu v poradí textu. Neodstraňuje biele znaky a vracia undefined. Uložená referencia na odstránený uzol stále odkazuje na ten istý objekt, ale objekt už nemá rodiča. Nejde o normalizáciu Unicode, ktorú vykonáva String.prototype.normalize().
Príklady
{
// Node.js has no document. This fallback models only the element and
// text-node behavior used below; in a browser, use the native DOM.
class ExampleNode {
parentNode = null;
childNodes = [];
constructor(data = null) {
this.data = data;
}
get firstChild() {
return this.childNodes[0] ?? null;
}
contains(node) {
for (let current = node; current !== null; current = current.parentNode) {
if (current === this) return true;
}
return false;
}
#detach() {
const parent = this.parentNode;
if (parent !== null) {
parent.childNodes.splice(parent.childNodes.indexOf(this), 1);
this.parentNode = null;
}
}
insertBefore(node, reference) {
if (node === reference) return node;
node.#detach();
const index = reference === null
? this.childNodes.length
: this.childNodes.indexOf(reference);
this.childNodes.splice(index, 0, node);
node.parentNode = this;
return node;
}
normalize() {
let previousText = null;
for (const child of [...this.childNodes]) {
if (child.data === null) {
child.normalize();
previousText = null;
} else if (child.data === "") {
child.#detach();
} else if (previousText !== null) {
previousText.data += child.data;
child.#detach();
} else {
previousText = child;
}
}
}
}
const doc = globalThis.document ?? {
createElement: () => new ExampleNode(),
createTextNode: (data) => new ExampleNode(data)
};
const root = doc.createElement("div");
const a = doc.createTextNode("A");
const b = doc.createTextNode("B");
const empty = doc.createTextNode("");
root.insertBefore(a, root.firstChild);
root.insertBefore(b, null);
root.insertBefore(empty, root.firstChild);
console.log(JSON.stringify([
root.contains(root), root.contains(null), root.contains(b),
b.parentNode === root, root.firstChild === empty, root.childNodes.length
]));
root.normalize();
console.log(JSON.stringify([
root.firstChild === a, root.firstChild.data, root.contains(b),
b.parentNode === null, root.childNodes.length
]));
}Výsledok
[true,false,true,true,true,3] [true,"AB",false,true,1]
Spusť kód v konzole prehliadača alebo v Node.js. `root` zostáva mimo dokumentu. Po normalizácii obsahuje `a` text `AB` a je jediným priamym potomkom, zatiaľ čo `b` je odpojený.
Súvisiace lekcie
- JavaScript · Lekcia 33 · Stredne pokročilá · Verzia: 3