CKTIS / JavaScript
Node.contains() a Node.isConnected: podstrom alebo dokument?
Pomocou `contains()` zistíš, či uzol patrí do konkrétneho podstromu, a pomocou `isConnected`, či je pripojený k dokumentu.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
container.contains(otherNode) // boolean; otherNode is a required argument that accepts a Node or null
node.isConnected // boolean; read-only propertycontainer.contains(otherNode) vráti true, ak je otherNode samotný uzol container alebo jeho priamy či nepriamy potomok v strome uzlov. Funguje aj v odpojenom podstrome. Argument je povinný: null dá výsledok false, ale vynechanie argumentu alebo odovzdanie selektora ako reťazca vyvolá TypeError.
node.isConnected je booleovská vlastnosť iba na čítanie, nie metóda. Má hodnotu true, ak je koreňom uzla po zohľadnení prechodov cez prípadných hostiteľov Shadow DOM objekt Document. Nemusí to byť aktuálny document a výsledok nič nehovorí o viditeľnosti. Po odpojení podstromu od dokumentu sa isConnected jeho uzlov zmení na false, ale vzťahy vnútri podstromu sa nezmenia.
contains() neprekračuje hranicu Shadow DOM. Uzol v tieňovom strome môže mať isConnected === true, keď je hostiteľ pripojený k dokumentu, hoci host.contains(shadowChild) vráti false. Obe sú súčasťou webového rozhrania DOM, nie ECMAScriptu 2024; ich dostupnosť závisí od prostredia, v ktorom kód beží.
Príklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOM checks</title>
</head>
<body>
<script>
{
const doc = document.implementation.createHTMLDocument("DOM checks");
const host = doc.createElement("div");
const child = doc.createElement("span");
const shadow = host.attachShadow({ mode: "open" });
const shadowChild = doc.createElement("span");
host.appendChild(child);
shadow.appendChild(shadowChild);
const report = (label) => {
console.log(`${label}: ${host.contains(child)} ${child.isConnected}`);
};
console.log(`self/null: ${host.contains(host)} ${host.contains(null)}`);
report("before");
doc.body.appendChild(host);
report("attached");
console.log(`shadow: ${host.contains(shadowChild)} ${shadow.contains(shadowChild)} ${shadowChild.isConnected}`);
host.remove();
report("detached");
}
</script>
</body>
</html>Výsledok
self/null: true false before: true false attached: true true shadow: false true true detached: true false
Ulož príklad ako súbor HTML, otvor ho v prehliadači a skontroluj výstup vo vývojárskej konzole. Vytvorí samostatný dokument HTML a otvorenú stránku nezmení. Po odstránení hostiteľa v ňom `child` zostane, ale `child.isConnected` bude znova `false`.
Súvisiace lekcie
- JavaScript · Lekcia 40 · Stredne pokročilá · Verzia: 3