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.