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.