Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element.after() — inserire nodi fratelli dopo un elemento

Element.after inserisce nodi e testo come nodi fratelli, di norma subito dopo l’elemento. Non aggiunge figli a quell’elemento.

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.after(...nodes)

Element.after è un metodo di istanza fornito dal mixin ChildNode nello standard DOM, non da ECMAScript. Se l’elemento ha un genitore, element.after(...nodes) inserisce di norma nodi e testo subito dopo l’elemento. Tuttavia, la preparazione dei nodi da inserire può spostare l’elemento stesso, anche se non viene passato direttamente come argomento. Se a è l’unico figlio di un DocumentFragment chiamato f e b è un elemento separato, a.after(b, f) sposta a fuori da f e lo colloca dopo b, poi inserisce entrambi in f nell’ordine b, a. Se si passa come argomento l’elemento stesso, la sua posizione nell’elenco degli argomenti conta: se a e b sono due elementi distinti con lo stesso genitore, a.after(b, a) colloca b subito prima di a.

Le stringhe diventano nodi Text senza essere interpretate come HTML. I nodi esistenti vengono spostati, non copiati. Il metodo restituisce undefined; se l’elemento non ha un genitore, non inserisce nulla. Il genitore non deve necessariamente essere collegato al documento.

Una gerarchia dell’albero non valida causa HierarchyRequestError. A differenza di append(), after() non inserisce figli nell’elemento su cui viene chiamato. Questa è un’API dell’ambiente DOM: la sola versione di Node.js non ne conferma la disponibilità.

Esempi

const parent = document.createElement('div');
const first = document.createElement('span');
first.textContent = 'A';
const last = document.createElement('span');
last.textContent = 'C';
parent.append(first, last);

const middle = document.createElement('strong');
middle.textContent = 'B';
const result = first.after(' / ', middle);

console.log(parent.textContent);
console.log(first.nextSibling.nodeType === Node.TEXT_NODE);
console.log(middle.nextSibling === last);
console.log(result === undefined);

Risultato

A / BC
true
true
true

Il codice mostrato e il risultato indicato sono stati verificati in un ambiente isolato con il metodo documentato per questa specifica versione.

Fonti