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 July 2015.

Die after()-Methode des CharacterData-Interfaces fügt eine Reihe von Node-Objekten oder Zeichenfolgen in die Kinderliste des Elternteils des Objekts 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 Menge von Node-Objekten oder Zeichenfolgen, die eingefügt werden sollen.

Ausnahmen

HierarchyRequestError DOMException

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

Wenn die Einfügung eines der hinzugefügten Knoten zu einem Zyklus führen würde, das heißt, wenn einer von ihnen ein Vorfahre dieses CharacterData-Knotens ist.
Wenn einer der hinzugefügten Knoten kein DocumentFragment, kein DocumentType, kein Element oder keine 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 das 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 die appendData()-Methode das Anhängen an die Daten des aktuellen Knotens.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser