Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Element.after() — vstavljanje sorodnih vozlišč za element

Element.after vstavi vozlišča in besedilo kot sorodna vozlišča elementa, navadno neposredno za njim. Temu elementu ne doda otrok.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

element.after(...nodes)

Element.after je metoda instance, ki jo v standardu DOM zagotavlja vmesnik tipa mixin ChildNode, ne pa ECMAScript. Če ima element nadrejeno vozlišče, element.after(...nodes) navadno vstavi vozlišča in besedilo neposredno za njim. Pri pripravi vozlišč za vstavljanje pa se lahko premakne tudi element sam, čeprav ni neposredno podan kot argument. Če je a edini otrok fragmenta DocumentFragment z imenom f in je b ločen element, a.after(b, f) premakne a iz f na mesto za b, nato pa oba elementa vstavi v f v vrstnem redu b, a. Če je med argumenti tudi element sam, je pomembno njegovo mesto na seznamu argumentov: če sta a in b različna elementa z istim nadrejenim vozliščem, a.after(b, a) postavi b neposredno pred a.

Nizi postanejo vozlišča Text, ne da bi se razčlenili kot HTML. Obstoječa vozlišča se premaknejo, ne kopirajo. Metoda vrne undefined; če element nima nadrejenega vozlišča, ne vstavi ničesar. Nadrejeno vozlišče ni nujno povezano z dokumentom.

Neveljavna hierarhija drevesa povzroči HierarchyRequestError. V nasprotju z append() metoda after() ne vstavi otrok v element, na katerem jo pokličemo. To je API okolja DOM: sama različica Node.js ne potrjuje njegove razpoložljivosti.

Primeri

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);

Rezultat

A / BC
true
true
true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, dokumentirano za to različico.

Viri