CharacterData
The CharacterData
abstract interface represents a Node
object that contains characters. This is an abstract interface, meaning there aren't any objects of type CharacterData
: it is implemented by other interfaces like Text
, Comment
, CDATASection
, or ProcessingInstruction
, which aren't abstract.
Properties
This interface also inherits properties from its parents, Node
and EventTarget
.
CharacterData.data
-
Is a string representing the textual data contained in this object.
CharacterData.length
Read only-
Returns a number representing the size of the string contained in the object.
CharacterData.nextElementSibling
Read only-
Returns the first
Element
that follows this node, and is a sibling. CharacterData.previousElementSibling
Read only-
Returns the first
Element
that precedes this node, and is a sibling.
Methods
This interface also inherits methods from its parents, Node
and EventTarget
.
CharacterData.after()
-
Inserts a set of
Node
objects or strings in the children list of theCharacterData
's parent, just after theCharacterData
object. CharacterData.appendData()
-
Appends the given string to the
CharacterData.data
string; when this method returns,data
contains the concatenatedDOMString
. CharacterData.before()
-
Inserts a set of
Node
objects or strings in the children list of theCharacterData
's parent, just before theCharacterData
object. CharacterData.deleteData()
-
Removes the specified amount of characters, starting at the specified offset, from the
CharacterData.data
string; when this method returns,data
contains the shortened string. CharacterData.insertData()
-
Inserts the specified characters, at the specified offset, in the
CharacterData.data
string; when this method returns,data
contains the modifiedDOMString
. CharacterData.remove()
-
Removes the object from its parent children list.
CharacterData.replaceData()
-
Replaces the specified amount of characters, starting at the specified offset, with the specified
DOMString
; when this method returns,data
contains the modified string. CharacterData.replaceWith()
-
Replaces the characters in the children list of its parent with a set of
Node
objects or strings. CharacterData.substringData()
-
Returns a
String
containing the part ofCharacterData.data
of the specified length and starting at the specified offset.
Specifications
Specification |
---|
DOM Standard # interface-characterdata |
Browser compatibility
BCD tables only load in the browser
See also
- The DOM overview page.
- The concrete interfaces implemented it:
Text
,CDATASection
,ProcessingInstruction
, andComment
.