CKTIS / JavaScript
ShadowRoot.append — aggiungere nodi e testo a un albero shadow
ShadowRoot.append aggiunge nodi e testo alla fine di un albero shadow. È ereditato da DocumentFragment, anziché essere un’implementazione separata. Scopri come vengono spostati i nodi, come si svuota un frammento e in cosa differisce da appendChild().
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
shadowRoot.append(...nodesOrStrings);
fragment.append(...nodesOrStrings);ShadowRoot.append è il metodo ereditato DocumentFragment.append: ShadowRoot eredita da DocumentFragment. La chiamata root.append(...) aggiunge contenuto dopo l’ultimo figlio della radice shadow, non tra i figli ordinari dell’elemento host. Un frammento normale serve invece ad assemblare un sottoalbero prima di inserirlo nella destinazione.
Il metodo accetta più nodi e stringhe, nell’ordine degli argomenti. Le stringhe diventano nodi Text; non vengono analizzate come HTML. Un nodo esistente viene spostato, non copiato. Passando un normale DocumentFragment, i suoi figli vengono spostati e il frammento resta vuoto; il frammento stesso non diventa un figlio della radice.
Il risultato è undefined. A differenza di append(), appendChild() accetta un solo nodo, non supporta direttamente stringhe come argomenti e restituisce il nodo aggiunto o il frammento svuotato. Un inserimento non valido, per esempio uno che crea un ciclo, può generare una DOMException HierarchyRequestError.
Questa è un’API DOM, non una funzionalità di una particolare edizione di ECMAScript. MDN indica che DocumentFragment.append() è ampiamente disponibile nei browser da aprile 2018; per usarlo su una radice shadow è necessario anche il supporto a Shadow DOM. La sola presenza di Node 24 in un repository non dimostra il supporto di queste API del browser.
Esempi
(() => {
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);
})();Risultato
Hello DOM! 3 0 true 0 true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.