Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti