Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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 property

container.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

Viri