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

CKTIS / JavaScript

`contains()` a `parentElement`: potomci a přímí rodiče v DOM

`contains()` ověřuje, zda je zadaný uzel totožný s výchozím uzlem nebo je jeho potomkem. `parentElement` vrací přímého rodiče, jen pokud je prvkem.

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

Syntaxe

container.contains(otherNode) // boolean; pass a Node or null
node.parentElement            // Element or null; read-only

container.contains(otherNode) vrací true, pokud je otherNode přímo uzel container nebo jeho potomek v libovolné hloubce, včetně textového uzlu. Pro null vrací false. Vynechání povinného argumentu nebo předání řetězce vyvolá TypeError. Chceš-li vyloučit samotný container, použij otherNode !== container && container.contains(otherNode).

node.parentElement je vlastnost pouze pro čtení, nikoli metoda. Vrací přímého rodiče, pokud je typu Element. Vrací null, pokud rodič neexistuje nebo je jiného typu, například Document nebo DocumentFragment. Výše ve stromu nehledá. Chceš-li získat přímého rodiče bez ohledu na jeho typ, použij node.parentNode.

Obě operace odrážejí aktuální strukturu stromu, i když strom není připojen k dokumentu. Přesunutí uzlu může změnit výsledek. Ani jedna operace nepřechází ze stromu shadow DOM na jeho hostitelský prvek: z pohledu contains() hostitel své uzly shadow DOM neobsahuje a parentElement přímého potomka ShadowRoot má hodnotu null.

Jde o členy rozhraní Node v DOM, nikoli o součást jazyka ECMAScript 2024. Jejich dostupnost závisí na tom, zda běhové prostředí poskytuje příslušná rozhraní DOM.

Příklady

<!doctype html>
<meta charset="utf-8">
<title>Node.contains() and Node.parentElement</title>
<script>
  const fragment = document.createDocumentFragment();
  const section = document.createElement("section");
  const span = document.createElement("span");
  const text = document.createTextNode("Hello");

  fragment.appendChild(section);
  section.appendChild(span);
  span.appendChild(text);

  console.log(`section.contains(text): ${section.contains(text)}`);
  console.log(`section.contains(section): ${section.contains(section)}`);
  console.log(`section.contains(null): ${section.contains(null)}`);
  console.log(`text.parentElement === span: ${text.parentElement === span}`);
  console.log(`section.parentElement: ${section.parentElement}`);
  console.log(`section.parentNode === fragment: ${section.parentNode === fragment}`);
</script>

Výsledek

section.contains(text): true
section.contains(section): true
section.contains(null): false
text.parentElement === span: true
section.parentElement: null
section.parentNode === fragment: true

Ulož příklad jako soubor `.html`, otevři ho v prohlížeči a zkontroluj výstup ve vývojářské konzoli. Odpojený fragment obsahuje `section`, ale není typu `Element`. Proto je `section.parentElement` rovno `null`, přestože `section.parentNode` je tento fragment.

Související lekce

  • JavaScript · Lekce 18 · Pokročilá · Verze: 4

Zdroje