JavaScript/DOM/Element/insertAdjacentElement
Aus SELFHTML-Wiki
< JavaScript | DOM | Element
Die Methode Element.insertAdjacentElement() fügt ein Element-Objekt im Umfeld des Elements ein, auf dem sie aufgerufen wird.
Dabei stehen vier mögliche Positionen zur Auswahl, von denen eine mit dem ersten Parameter der Methode ausgewählt werden muss:
- auf gleicher Ebene, als Geschwister-Element
-
'beforebegin': als direkter Vorgänger -
'afterend': als direkter Nachfolger
-
- eine Ebene tiefer, als Kind-Element
-
'afterbegin': als erstes Kind -
'beforeend': als letztes Kind
-
Syntax
neuesElement = element.insertAdjacentElement(position, neuesElement);
-
element: Element, in dessen Nachbarschaft das neue Element einzufügen ist -
position: Bezeichnung der Einfügeposition wie oben beschrieben, als String -
neuesElement: Das einzufügende Element
Die Methode gibt das neue Element zurück oder null, wenn das Einfügen fehlschlägt. Ein Fehlschlag ist möglich, wenn das neue Element als Geschwisterelement eingefügt werden soll, das Bezugselement aber kein Parent-Element hat (z. B. weil es selbst noch nirgends eingefügt wurde).
Wird ein unbekannter Wert als Einfügeposition übergeben, wirft die Methode eine "SyntaxError" DOMException.
