CKTIS / JavaScript
Element.before() — vloženie pred element
Element.before() vkladá uzly a text do rodičovského uzla, nie do samotného elementu. Zvyčajne ich vloží pred referenčný element.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.before(...nodes)Element.before je metóda DOM z mixinu ChildNode, nie funkcia ECMAScriptu. element.before(...nodes) prijíma uzly a reťazce; reťazce sa menia na uzly Text, nie na HTML.
Existujúce uzly sa presúvajú, nekopírujú. Ak ako argument odovzdáš samotný referenčný element, môže sa presunúť aj ten. Ak je rodičom target uzol typu Element alebo DocumentFragment, volanie target.before(target, 'x') umiestni text za target, nie pred neho. Ak je target koreňovým elementom dokumentu, rovnaké volanie vyvolá výnimku HierarchyRequestError: fragment s uzlom Text ako priamym potomkom nemožno vložiť do uzla Document. Pri úspešnom volaní metóda vracia undefined.
Element bez rodiča zostane nezmenený; rodič nemusí patriť do dokumentu. Neplatná hierarchia spôsobí HierarchyRequestError. Na rozdiel od parent.insertBefore(node, element) voláš túto metódu na referenčnom elemente.
Príklady
const parent = document.createElement('div');
const target = document.createElement('span');
target.textContent = 'B';
parent.appendChild(target);
const first = document.createElement('strong');
first.textContent = 'A';
const result = target.before(first, ' + ');
console.log(parent.textContent);
console.log(parent.firstChild === first);
console.log(result === undefined);Výsledok
A + B true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v doklade o overení práve tejto verzie.