Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

`contains()` a `parentElement`: potomkovia a priami rodičia v DOM

`contains()` overuje, či je zadaný uzol totožný s východiskovým uzlom alebo je jeho potomkom. `parentElement` vráti priameho rodiča, iba ak je prvkom.

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

Syntax

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

container.contains(otherNode) vráti true, ak je otherNode samotný container alebo jeho potomok v ľubovoľnej hĺbke vrátane textového uzla. Pre null vráti false. Vynechanie povinného argumentu alebo odovzdanie reťazca vyvolá TypeError. Ak chceš vylúčiť samotný container, použi otherNode !== container && container.contains(otherNode).

node.parentElement je vlastnosť určená iba na čítanie, nie metóda. Vráti priameho rodiča, ak je typu Element. Vráti null, ak rodič neexistuje alebo je iného typu, napríklad Document alebo DocumentFragment. Vo vyšších úrovniach stromu nehľadá. Na získanie priameho rodiča bez ohľadu na jeho typ použi node.parentNode.

Obe operácie odrážajú aktuálnu štruktúru stromu, aj keď strom nie je pripojený k dokumentu. Presunutie uzla môže zmeniť výsledok. Ani jedna operácia neprechádza zo stromu shadow DOM na jeho hostiteľský prvok: podľa contains() hostiteľ svoje uzly shadow DOM neobsahuje a parentElement priameho dieťaťa ShadowRoot má hodnotu null.

Ide o členy rozhrania Node v DOM, nie o súčasť jazyka ECMAScript 2024. Ich dostupnosť závisí od toho, či prostredie vykonávania poskytuje príslušné rozhrania DOM.

Prí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ýsledok

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

Ulož príklad ako súbor `.html`, otvor ho v prehliadači a skontroluj výstup vo vývojárskej konzole. Odpojený fragment obsahuje `section`, ale nie je typu `Element`. Preto má `section.parentElement` hodnotu `null`, hoci `section.parentNode` je tento fragment.

Súvisiace lekcie

  • JavaScript · Lekcia 18 · Pokročilá · Verzia: 4

Zdroje