CKTIS / JavaScript
ShadowRoot.append — knooppunten en tekst aan een shadow tree toevoegen
ShadowRoot.append voegt knooppunten en tekst toe aan het einde van een shadow tree. De methode wordt overgenomen van DocumentFragment en is geen aparte implementatie. Lees hoe knooppunten worden verplaatst, een fragment leeg raakt en appendChild() hiervan verschilt.
Versie: 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 is de overgenomen methode DocumentFragment.append: ShadowRoot erft van DocumentFragment. Met root.append(...) voeg je inhoud toe na het laatste kind van de shadow root, niet aan de gewone kinderen van het host-element. Een gewoon fragment dient juist om een subtree samen te stellen voordat je die op de bestemming invoegt.
De methode accepteert meerdere knooppunten en tekenreeksen in de volgorde van de argumenten. Tekenreeksen worden Text-knooppunten; ze worden niet als HTML geparseerd. Een bestaand knooppunt wordt verplaatst, niet gekopieerd. Geef je een gewoon DocumentFragment door, dan worden de kinderen ervan verplaatst en blijft het fragment leeg; het fragment zelf wordt geen kind van de root.
Het resultaat is undefined. In tegenstelling tot append() accepteert appendChild() één knooppunt, ondersteunt het tekenreeksargumenten niet rechtstreeks en retourneert het het toegevoegde knooppunt of het leeggemaakte fragment. Een ongeldige invoeging, bijvoorbeeld een die een cyclus veroorzaakt, kan een HierarchyRequestError-DOMException veroorzaken.
Dit is een DOM-API, geen functie van een bepaalde ECMAScript-editie. MDN markeert DocumentFragment.append() sinds april 2018 als breed beschikbaar in browsers; gebruik op een shadow root vereist ook ondersteuning voor Shadow DOM. De aanwezigheid van Node 24 in een repository bewijst op zichzelf niet dat deze browser-API’s worden ondersteund.
Voorbeelden
(() => {
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);
})();Resultaat
Hello DOM! 3 0 true 0 true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.