CharacterData: Methode after()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2018 browserübergreifend verfügbar.
Die Methode after() der Schnittstelle CharacterData fügt eine Reihe von Node-Objekten oder Zeichenfolgen in die Liste der Kindknoten des Elternknotens von CharacterData ein, unmittelbar nach CharacterData. Zeichenfolgen werden als entsprechende Text-Knoten eingefügt. Wenn parentNode null ist, geschieht nichts.
Syntax
after(param1)
after(param1, param2)
after(param1, param2, /* …, */ paramN)
Parameter
param1, …,paramN-
Eine Reihe von
Node-Objekten oder Zeichenfolgen, die eingefügt werden sollen.
Rückgabewert
Keiner (undefined).
Ausnahmen
HierarchyRequestErrorDOMException-
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:
- Das Einfügen eines der hinzuzufügenden Knoten würde einen Zyklus erzeugen, das heißt, einer dieser Knoten ist ein Vorfahr dieses
CharacterData-Knotens. - Einer der hinzuzufügenden Knoten ist weder ein
DocumentFragmentnoch einDocumentType, einElementoder einCharacterData. - Dieser
CharacterData-Knoten ist einText-Knoten und sein Elternknoten ist einDocument. - Der Elternknoten dieses
CharacterData-Knotens ist einDocument, und einer der einzufügenden Knoten ist einDocumentFragmentmit mehr als einemElement-Kindknoten oder mit einemText-Kindknoten.
- Das Einfügen eines der hinzuzufügenden Knoten würde einen Zyklus erzeugen, das heißt, einer dieser Knoten ist ein Vorfahr dieses
Beispiele
Mit der Methode after() können Sie neue Knoten nach einem CharacterData-Knoten einfü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, können Sie mit der Methode appendData() Daten an den aktuellen Knoten anhängen.
Spezifikationen
| Spezifikation |
|---|
| DOM # ref-for-dom-childnode-after① |