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

CKTIS / JavaScript

ShadowRoot.append — pridávanie uzlov a textu do tieňového stromu

ShadowRoot.append pridáva uzly a text na koniec tieňového stromu. Metódu dedí z DocumentFragment; nejde o samostatnú implementáciu. Zistite, ako sa uzly presúvajú, ako sa fragment vyprázdni a v čom sa appendChild() líši.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

shadowRoot.append(...nodesOrStrings);
fragment.append(...nodesOrStrings);

ShadowRoot.append je zdedená metóda DocumentFragment.append: ShadowRoot dedí z DocumentFragment. Volanie root.append(...) pridá obsah za posledné dieťa tieňového koreňa, nie medzi bežné deti hostiteľského elementu. Bežný fragment slúži na zostavenie podstromu pred jeho vložením na cieľové miesto.

Metóda prijíma viacero uzlov a reťazcov v poradí argumentov. Reťazce sa zmenia na uzly Text; neparsujú sa ako HTML. Existujúci uzol sa presunie, nie skopíruje. Pri odovzdaní bežného DocumentFragment sa jeho deti presunú a fragment zostane prázdny; samotný fragment sa dieťaťom koreňa nestane.

Výsledkom je undefined. Na rozdiel od append() prijíma appendChild() jeden uzol, priamo nepodporuje reťazcové argumenty a vracia pridaný uzol alebo vyprázdnený fragment. Neplatné vloženie, napríklad také, ktoré vytvorí cyklus, môže vyvolať DOMException HierarchyRequestError.

Ide o DOM API, nie o funkciu konkrétnej edície ECMAScriptu. MDN označuje DocumentFragment.append() za široko dostupné v prehliadačoch od apríla 2018; použitie na tieňovom koreni vyžaduje aj podporu Shadow DOM. Samotná prítomnosť Node 24 v repozitári nedokazuje podporu týchto API prehliadača.

Príklady

(() => {
  const host = document.createElement("div");
  const root = host.attachShadow({ mode: "open" });
  const fragment = document.createDocumentFragment();
  const label = document.createElement("strong");
  label.textContent = "DOM";

  fragment.append("Hello ", label);
  const result = root.append(fragment, "!");

  console.log(root.textContent);
  console.log(root.childNodes.length);
  console.log(fragment.childNodes.length);
  console.log(label.parentNode === root);
  console.log(host.childNodes.length);
  console.log(result === undefined);
})();

Výsledok

Hello DOM!
3
0
true
0
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje