Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Node.contains() a Node.isConnected: podstrom, nebo dokument?

Pomocí `contains()` zjistíš, zda uzel patří do konkrétního podstromu, a pomocí `isConnected`, zda je připojený k dokumentu.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

container.contains(otherNode) // boolean; otherNode is a required argument that accepts a Node or null
node.isConnected              // boolean; read-only property

container.contains(otherNode) vrací true, pokud je otherNode samotný uzel container nebo jeho přímý či nepřímý potomek ve stromu uzlů. Funguje i v odpojeném podstromu. Argument je povinný: null vrátí false, ale vynechání argumentu nebo předání selektoru jako řetězce vyvolá TypeError.

node.isConnected je booleovská vlastnost pouze pro čtení, ne metoda. Má hodnotu true, pokud je kořenem uzlu po zohlednění cest přes případné hostitele Shadow DOM objekt Document. Nemusí to být aktuální document a výsledek nic neříká o viditelnosti. Po odpojení podstromu od dokumentu se isConnected u jeho uzlů změní na false, ale jejich vztahy uvnitř podstromu zůstanou stejné.

contains() nepřekračuje hranici Shadow DOM. Uzel ve stínovém stromu může mít isConnected === true, pokud je hostitel připojený k dokumentu, přestože host.contains(shadowChild) vrací false. Obě rozhraní jsou součástí webového DOM, nikoli ECMAScriptu 2024; jejich dostupnost závisí na běhovém prostředí.

Pří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ýsledek

self/null: true false
before: true false
attached: true true
shadow: false true true
detached: true false

Ulož příklad jako soubor HTML, otevři ho v prohlížeči a zkontroluj výstup v konzoli pro vývojáře. Vytvoří samostatný dokument HTML a otevřenou stránku nezmění. Po odebrání hostitele v něm `child` zůstane, ale `child.isConnected` bude opět `false`.

Související lekce

  • JavaScript · Lekce 40 · Středně pokročilá · Verze: 3

Zdroje