JavaScript/DOM/CharacterData

Die CharacterData-Schnittstelle ist eine Erweiterung der Node-Schnittstelle, die für Knoten mit Textinhalt genutzt wird. Es handelt sich um eine abstrakte Schnittstelle, das heißt: es gibt keinen Knotentyp im DOM, den diese Schnittstelle direkt repräsentiert. Statt dessen sind von ihr weitere Schnittstellen abgeleitet:

• Text - für normale Textknoten (Nodetyp 3)
• Comment - für Kommentare (Nodetyp 8)
• CDATASection - für <![CDATA[ … ]]> Bereiche in XML-Dokumenten (Nodetyp 4)
• ProcessingInstruction - Verarbeitungsanweisungen in XML-Dokumenten (Nodetyp 7)

Die im Folgenden aufgelisteten Eigenschaften und Methoden sind allen diesen Node-Typen gemeinsam.

Eigenschaften

• data
• length
• nextElementSibling
• previousElementSibling

Methoden

• appendData()
• deleteData()
• insertData()
• replaceData()

Für die folgenden Methoden wird auf die Element-Dokumentation verwiesen:

• after()
• before()
• remove()
• replaceWith()

Eigenschaften

data

Die data-Eigenschaft enthält den Textinhalt des Knotens (Text, CDATA-Text, Kommentarinhalt, Inhalt eines <?...?> XML Elements) als Zeichenkette.

length

Die Länge des Textinhaltes

Methoden

appendData

Syntax: node.appendData(text);

Der an appendData übergebene Text wird an den vorhandenen Text des Knotens angehängt.

deleteData

Syntax: node.deleteData(position, anzahl);

Entfernt ab der angegebenen position anzahl Zeichen aus dem Knotentext

insertData

Syntax: node.insertData(position, text);

Fügt den übergebenen text an der angegebenen position in den Knotentext ein.

replaceData

Syntax: node.replaceData(position, anzahl, text);

Ersetzt ab der angegebnen position anzahl Zeichen durch neuen text.

substringData

Syntax: let substring = node.substringData(position, länge);

Fügt den als data übergebenen Text an der angegebenen position in den Knotentext ein.