Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti