CKTIS / JavaScript
Node.contains() in Node.isConnected: poddrevo ali dokument?
Z `contains()` preveriš, ali vozlišče pripada določenemu poddrevesu, z `isConnected` pa, ali je povezano z dokumentom.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
container.contains(otherNode) // boolean; otherNode is a required argument that accepts a Node or null
node.isConnected // boolean; read-only propertycontainer.contains(otherNode) vrne true, če je otherNode kar container ali eden od njegovih neposrednih ali posrednih potomcev v drevesu vozlišč. Deluje tudi v odklopljenem poddrevesu. Argument je obvezen: null da rezultat false, če pa argument izpustiš ali podaš izbirnik kot niz, se sproži TypeError.
node.isConnected je logična lastnost samo za branje, ne metoda. Njena vrednost je true, če je koren vozlišča ob upoštevanju prehodov prek morebitnih gostiteljev Shadow DOM objekt Document. To ni nujno trenutni document, rezultat pa ne pove ničesar o vidnosti. Ko poddrevo ločiš od dokumenta, postane isConnected za njegova vozlišča false, njihova razmerja znotraj poddrevesa pa se ne spremenijo.
contains() ne prečka meje Shadow DOM. Vozlišče v senčnem drevesu ima lahko isConnected === true, če je gostitelj povezan z dokumentom, čeprav host.contains(shadowChild) vrne false. Oba sta dela spletnega vmesnika DOM, ne zmožnosti ECMAScript 2024; razpoložljivost je odvisna od izvajalnega okolja.
Primeri
<!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>Rezultat
self/null: true false before: true false attached: true true shadow: false true true detached: true false
Shrani primer kot datoteko HTML, odpri jo v brskalniku in preveri izpis v konzoli za razvijalce. Primer ustvari ločen dokument HTML in ne spremeni odprte strani. Ko odstraniš gostitelja, `child` ostane v njem, vendar `child.isConnected` znova postane `false`.
Povezane lekcije
- JavaScript · Lekcija 40 · Srednja · Različica: 3