DieinsertAdjacentText()-Methode desElement-Interfaces fügt an einer angegebenen relativen Position und basierend auf einem übergebenen String einen neuen Textknoten relativ zu dem Element ein, von dem sie aufgerufen wird.

Syntax

insertAdjacentText(where, data)

Parameter

where

Ein String, der die Position relativ zu dem Element darstellt, von dem die Methode aufgerufen wird. Er muss einer der folgenden Strings sein:

• 'beforebegin': Vor demelement selbst.
• 'afterbegin': Direkt innerhalb deselement, vor dessen erstem Kind.
• 'beforeend': Direkt innerhalb deselement, nach dessen letztem Kind.
• 'afterend': Nach demelement selbst.

data

Ein String, aus dem ein neuer Textknoten erstellt wird, der an der angegebenen Positionwhere relativ zu dem Element eingefügt wird, von dem die Methode aufgerufen wird.

Rückgabewert

Keiner (undefined).

Ausnahmen

SyntaxErrorDOMException

Wird ausgelöst, wennwhere keinen anerkannten Wert hat.

Visualisierung der Positionsnamen

<!-- beforebegin --><p>  <!-- afterbegin -->  foo  <!-- beforeend --></p><!-- afterend -->

Beispiele

beforeBtn.addEventListener("click", () => {  para.insertAdjacentText("afterbegin", textInput.value);});afterBtn.addEventListener("click", () => {  para.insertAdjacentText("beforeend", textInput.value);});

Werfen Sie einen Blick auf unserinsertAdjacentText.htmlDemo auf GitHub (siehe auch denQuellcode). Hier haben wir einen einfachen Absatz. Sie können etwas Text in das Formularelement eingeben und dann die SchaltflächenInsert before undInsert after drücken, um ihn vor oder nach dem bestehenden Absatztext mitinsertAdjacentText() einzufügen. Beachten Sie, dass der vorhandene Textknoten nicht ergänzt wird – es werden weitere Textknoten erstellt, die die neuen Ergänzungen enthalten.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Element.insertAdjacentElement()
• Element.insertAdjacentHTML()