Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Node.contains() i Node.isConnected: podstablo ili dokument?

Pomoću `contains()` provjeri pripada li čvor određenom podstablu, a pomoću `isConnected` provjeri je li povezan s dokumentom.

Verzija: 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) vraća true ako je otherNode sam čvor container ili njegov izravni ili neizravni potomak u stablu čvorova. Radi i u odvojenom podstablu. Argument je obavezan: null daje false, ali izostavljanje argumenta ili prosljeđivanje selektora kao znakovnog niza izaziva TypeError.

node.isConnected je logičko svojstvo samo za čitanje, a ne metoda. Vrijednost mu je true ako je korijen čvora, uzimajući u obzir prolazak kroz moguće domaćine Shadow DOM-a, objekt Document. To ne mora biti trenutni document, a rezultat ne govori ništa o vidljivosti. Kad se podstablo odvoji od dokumenta, isConnected njegovih čvorova postaje false, ali njihovi se odnosi unutar podstabla ne mijenjaju.

contains() ne prelazi granicu Shadow DOM-a. Čvor u stablu sjene može imati isConnected === true ako je domaćin povezan s dokumentom, iako host.contains(shadowChild) vraća false. Oboje pripadaju web-sučelju DOM, a ne standardu ECMAScript 2024; dostupnost ovisi o izvršnom okruženju.

Primjeri

<!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

Spremi primjer kao HTML datoteku, otvori je u pregledniku i provjeri ispis u konzoli za razvojne programere. Primjer stvara zaseban HTML dokument i ne mijenja otvorenu stranicu. Nakon uklanjanja domaćina `child` ostaje u njemu, ali `child.isConnected` ponovno postaje `false`.

Povezane lekcije

  • JavaScript · Lekcija 40 · Srednje · Verzija: 3

Izvori