CharacterData: after()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.

Die after()-Methode der CharacterData-Schnittstelle fügt eine Reihe von Node-Objekten oder Zeichenfolgen in die Kinderliste des Elternobjekts ein, direkt nach dem Objekt selbst.

Zeichenfolgen werden als Text-Knoten eingefügt; die Zeichenfolge wird als Argument an den Text()-Konstruktor übergeben.

Syntax

after(...nodes)

Parameter

nodes: Eine Reihe von Node-Objekten oder Zeichenfolgen zum Einfügen.

Rückgabewert

Keiner (undefined).

Ausnahmen

HierarchyRequestError DOMException

Wird ausgelöst, wenn die neuen Knoten nicht an der angegebenen Stelle in der Hierarchie eingefügt werden können, wenn eine der folgenden Bedingungen erfüllt ist:

Wenn das Einfügen eines der hinzugefügten Knoten zu einem Zyklus führen würde, d.h. wenn einer von ihnen ein Vorfahre dieses CharacterData-Knotens ist.
Wenn einer der hinzugefügten Knoten kein DocumentFragment, DocumentType, Element oder CharacterData ist.
Wenn dieser CharacterData-Knoten tatsächlich ein Text-Knoten ist und sein Elternteil ein Document ist.
Wenn das Elternteil dieses CharacterData-Knotens ein Document ist und einer der einzufügenden Knoten ein DocumentFragment mit mehr als einem Element-Kind ist oder ein Text-Kind hat.

Beispiele

Die after()-Methode ermöglicht es Ihnen, neue Knoten nach einem CharacterData-Knoten einzufügen.

const h1TextNode = document.querySelector("h1").firstChild;
h1TextNode.after(" #h1");

h1TextNode.parentElement.childNodes;
// NodeList [#text "CharacterData.after()", #text " #h1"]

h1TextNode.data;
// "CharacterData.after()"

Hinweis: Wenn Sie stattdessen Text an den aktuellen Knoten anhängen möchten, ermöglicht Ihnen die appendData()-Methode, Daten an den aktuellen Knoten anzuhängen.

Spezifikationen

Specification
DOM # ref-for-dom-childnode-after①