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.