CKTIS / JavaScript
Element.append — aggiungere nodi e testo
`Element.append` aggiunge nodi e testo alla fine di un elemento e restituisce `undefined`. Se `a` e `b` sono due elementi distinti, dopo una chiamata a `element.append(a, b, a)` riuscita, in fondo si trovano `b` e poi `a`: l’ultima occorrenza di `a` sposta il nodo anziché copiarlo. Se invece `a` è un `DocumentFragment` che contiene un solo nodo di testo e `b` è un elemento separato, la prima occorrenza di `a` colloca il nodo di testo prima di `b` e svuota il frammento. L’ultima occorrenza non aggiunge nulla e il frammento stesso non viene inserito.
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
element.append(...nodes)Element.append proviene dal mixin ParentNode dello standard DOM, non da ECMAScript. Aggiunge zero o più argomenti dopo l’ultimo figlio dell’elemento.
Le stringhe diventano nodi Text, non markup HTML. Un nodo esistente viene spostato, non copiato. Un DocumentFragment aggiunge i propri figli e diventa vuoto.
A differenza di appendChild, append accetta più argomenti, incluso il testo, e restituisce undefined. Una gerarchia non valida, ad esempio inserire un elemento al suo interno, causa HierarchyRequestError.
Esempi
const box = document.createElement('div');
const label = document.createElement('span');
label.textContent = 'OK';
const result = box.append('Status: ', label, '!');
console.log(box.textContent);
console.log(box.childNodes.length);
console.log(result);Risultato
Status: OK! 3 undefined
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.