CKTIS / JavaScript
ShadowRoot.append — přidávání uzlů a textu do stínového stromu
ShadowRoot.append přidává uzly a text na konec stínového stromu. Metoda je zděděná z DocumentFragment, nejde o samostatnou implementaci. Zjistěte, jak se uzly přesouvají, jak se fragment vyprázdní a v čem se appendChild() liší.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
shadowRoot.append(...nodesOrStrings);
fragment.append(...nodesOrStrings);ShadowRoot.append je zděděná metoda DocumentFragment.append: ShadowRoot dědí z DocumentFragment. Volání root.append(...) přidá obsah za poslední dítě stínového kořene, nikoli mezi běžné děti hostitelského elementu. Běžný fragment naopak slouží k sestavení podstromu před jeho vložením na cílové místo.
Metoda přijímá více uzlů a řetězců v pořadí argumentů. Řetězce se stanou uzly Text; neparsují se jako HTML. Existující uzel se přesune, nezkopíruje. Předání běžného DocumentFragment přesune jeho děti a fragment zůstane prázdný; samotný fragment se dítětem kořene nestane.
Výsledkem je undefined. Na rozdíl od append() přijímá appendChild() jeden uzel, přímo nepodporuje řetězcové argumenty a vrací přidaný uzel nebo vyprázdněný fragment. Neplatné vložení, například takové, které vytvoří cyklus, může vyvolat DOMException HierarchyRequestError.
Jde o DOM API, nikoli o funkci konkrétní edice ECMAScriptu. MDN označuje DocumentFragment.append() za široce dostupné napříč prohlížeči od dubna 2018; použití na stínovém kořeni vyžaduje také podporu Shadow DOM. Samotná přítomnost Node 24 v repozitáři nedokládá podporu těchto API prohlížeče.
Pří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ýsledek
Hello DOM! 3 0 true 0 true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.