{{DOMRef}}
The CharacterData
abstract interface represents a {{domxref("Node")}} object that contains characters. This is an abstract interface, meaning there aren't any object of type CharacterData
: it is implemented by other interfaces, like {{domxref("Text")}}, {{domxref("Comment")}}, or {{domxref("ProcessingInstruction")}} which aren't abstract.
Properties
Inherits properties from its parent, {{domxref("Node")}}, and implements the {{domxref("ChildNode")}} interface.
- {{domxref("CharacterData.data")}}
- Is a {{domxref("DOMString")}} representing the textual data contained in this object.
- {{domxref("CharacterData.length")}} {{readonlyInline}}
-
Returns an
unsigned long
representing the size of the string contained inCharacterData.data
. - {{domxref("ChildNode.nextElementSibling")}} {{readonlyInline}}
-
Returns the {{domxref("Element")}} immediately following the specified one in its parent's children list, or
null
if the specified element is the first one in the list. - {{domxref("ChildNode.previousElementSibling")}} {{readonlyInline}}
-
Returns the {{domxref("Element")}} immediately prior to the specified one in its parent's children list, or
null
if the specified element is the first one in the list.
Methods
Inherits methods from its parent, {{domxref("Node")}}, and implements the {{domxref("ChildNode")}} interface.
- {{domxref("CharacterData.appendData")}}
-
Appends the given {{domxref("DOMString")}} to the
CharacterData.data
string; when this method returns,data
contains the concatenated {{domxref("DOMString")}}. - {{domxref("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 {{domxref("DOMString")}}. - {{domxref("CharacterData.insertData")}}
-
Inserts the specified characters, at the specified offset, in the
CharacterData.data
string; when this method returns,data
contains the modified {{domxref("DOMString")}}. - {{domxref("ChildNode.remove")}} {{experimental_inline}}
- Removes the object from its parent children list.
- {{domxref("CharacterData.replaceData")}}
-
Replaces the specified amount of characters, starting at the specified offset, with the specified {{domxref("DOMString")}}; when this method returns,
data
contains the modified {{domxref("DOMString")}}. - {{domxref("CharacterData.substringData")}}
-
Returns a {{domxref("DOMString")}} containing the part of
CharacterData.data
of the specified length and starting at the specified offset.
Specifications
Specification | Status | Comment |
---|---|---|
{{SpecName('DOM WHATWG', '#characterdata', 'CharacterData')}} | {{Spec2('DOM WHATWG')}} | Added implemention of the {{domxref("ChildNode")}} interface. |
{{SpecName('DOM3 Core', 'core.html#ID-FF21A306', 'CharacterData')}} | {{Spec2('DOM3 Core')}} | No change from {{SpecName('DOM2 Core')}}. |
{{SpecName('DOM2 Core', 'core.html#ID-FF21A306', 'CharacterData')}} | {{Spec2('DOM2 Core')}} | No change from {{SpecName('DOM1')}}. |
{{SpecName('DOM1', 'level-one-core.html#ID-FF21A306', 'CharacterData')}} | {{Spec2('DOM1')}} | Initial definition. |
Browser compatibility
{{CompatibilityTable}}
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 1.0 | {{CompatGeckoDesktop("1.0")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
Implements {{domxref("ChildNode")}} interface. | {{CompatUnknown}} | {{CompatGeckoDesktop("25.0")}} | {{CompatNo}} | {{CompatUnknown}} | {{CompatNo}} |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | {{CompatVersionUnknown}} | {{CompatGeckoMobile("1.0")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
Implements {{domxref("ChildNode")}} interface. | {{CompatUnknown}} | {{CompatGeckoMobile("25.0")}} | {{CompatNo}} | {{CompatUnknown}} | {{CompatNo}} |