Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

ShadowRoot.append — dodavanje čvorova i teksta u stablo sjene

ShadowRoot.append dodaje čvorove i tekst na kraj stabla sjene. Metoda je naslijeđena od DocumentFragmenta, a ne zasebna implementacija. Saznajte kako se čvorovi premještaju, kako se fragment prazni i po čemu se appendChild() razlikuje.

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

Sintaksa

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

ShadowRoot.append naslijeđena je metoda DocumentFragment.append: ShadowRoot nasljeđuje od DocumentFragment. Poziv root.append(...) dodaje sadržaj nakon posljednjeg djeteta korijena sjene, a ne među običnu djecu elementa domaćina. Obični fragment služi za sastavljanje podstabla prije umetanja na odredište.

Metoda prihvaća više čvorova i nizova, redoslijedom argumenata. Nizovi postaju čvorovi Text; ne parsiraju se kao HTML. Postojeći čvor premješta se, a ne kopira. Predajom običnog DocumentFragmenta premještaju se njegova djeca i fragment ostaje prazan; sam fragment ne postaje dijete korijena.

Rezultat je undefined. Za razliku od append(), appendChild() prihvaća jedan čvor, ne podržava izravno nizove kao argumente i vraća dodani čvor ili ispražnjeni fragment. Nevaljano umetanje, primjerice ono koje stvara ciklus, može izazvati DOMException HierarchyRequestError.

Ovo je DOM API, a ne značajka određenog izdanja ECMAScripta. MDN navodi da je DocumentFragment.append() široko dostupan u preglednicima od travnja 2018.; za upotrebu na korijenu sjene potrebna je i podrška za Shadow DOM. Sama prisutnost Node 24 u repozitoriju ne potvrđuje podršku za ove API-je preglednika.

Primjeri

(() => {
  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);
})();

Rezultat

Hello DOM!
3
0
true
0
true

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori