All Superinterfaces:

Node

All Known Subinterfaces:

CDATASection ， Comment ， Text ， Text
```
public interface CharacterData
extends Node
```
CharacterData接口使用一组用于访问DOM中的字符数据的属性和方法来扩展Node。为了清楚起见，这个集合是在这里定义的，而不是使用这些属性和方法的每个对象。没有DOM对象直接对应到CharacterData ，尽管其中Text等从它继承了接口。全部offsets在此界面从0开始。
如DOMString接口中所述，DOM中的文本字符串以UTF-16表示，即以16位为单位。在下文中，术语16位单位在需要时使用，表示CharacterData的索引以16位为单位完成。

另见Document Object Model (DOM) Level 3 Core Specification 。

Field Summary
- Fields inherited from interface org.w3c.dom.Node
  ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

方法摘要

所有方法接口方法抽象方法
Modifier and Type	方法	描述
`void`	`appendData(String arg)`	将字符串附加到节点的字符数据的末尾。
`void`	`deleteData(int offset, int count)`	从节点中删除一个16位的单位范围。
`String`	`getData()`	实现此接口的节点的字符数据。
`int`	`getLength()`	可通过 `data`获得的16位单位 `data`和下面的 `substringData`方法。
`void`	`insertData(int offset, String arg)`	以指定的16位单位偏移量插入字符串。
`void`	`replaceData(int offset, int count, String arg)`	用指定的字符串替换从指定的16位单位偏移开始的字符。
`void`	`setData(String data)`	实现此接口的节点的字符数据。
`String`	`substringData(int offset, int count)`	从节点中提取一系列数据。

Methods inherited from interface org.w3c.dom.Node
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

- 方法详细信息
  - getData
```
String getData()
        throws DOMException
```
    实现此接口的节点的字符数据。 DOM实现可能不会对可能存储在CharacterData节点中的数据量进行任意限制。然而，实施限制可能意味着节点数据的整体可能不适合单个DOMString 。在这种情况下，用户可以调用substringData以适当大小的片段检索数据。
    
    异常
    
    DOMException - DOMSTRING_SIZE_ERR：在实现平台的 DOMString变量中返回更多字符时 DOMString 。
  - setData
```
void setData(String data)
      throws DOMException
```
    实现此接口的节点的字符数据。 DOM实现可能不会对可能存储在CharacterData节点中的数据量进行任意限制。然而，实施限制可能意味着节点数据的整体可能不适合单个DOMString 。在这种情况下，用户可以拨打substringData以适当大小的片段检索数据。
    
    异常
    
    DOMException - NO_MODIFICATION_ALLOWED_ERR：当节点只读时提升。
  - getLength
```
int getLength()
```
    可通过data获得的16位单元data和下面的substringData方法。这可能具有零值，即CharacterData节点可能为空。
  - substringData
```
String substringData(int offset,
                     int count)
              throws DOMException
```
    从节点中提取一系列数据。
    
    参数
    
    offset - 要提取的子字符串的起始偏移量。
    
    count - 要提取的16位单位数。
    
    结果
    
    指定的子字符串。如果offset和count的总和超过了length ，则返回到数据结尾的所有16位单位。
    
    异常
    
    DOMException - INDEX_SIZE_ERR：如果指定的offset为负数或大于offset中的16位单元data ，或者指定的count为负数则count 。
    DOMSTRING_SIZE_ERR：如果指定的文本范围不适用于DOMString 。
  - appendData
```
void appendData(String arg)
         throws DOMException
```
    将字符串附加到节点的字符数据的末尾。成功后， data提供对data的连接和指定的data的DOMString 。
    
    参数
    
    arg - 要追加的 DOMString 。
    
    异常
    
    DOMException - NO_MODIFICATION_ALLOWED_ERR：如果此节点是只读的，则引发。
  - insertData
```
void insertData(int offset,
                String arg)
         throws DOMException
```
    以指定的16位单位偏移量插入字符串。
    
    参数
    
    offset - 要插入的字符偏移量。
    
    arg - 要插入的 DOMString 。
    
    异常
    
    DOMException - INDEX_SIZE_ERR：如果指定的offset为负值或大于offset中的16位单元数，则data 。
    NO_MODIFICATION_ALLOWED_ERR：如果此节点是只读的，则引发。
  - deleteData
```
void deleteData(int offset,
                int count)
         throws DOMException
```
    从节点中删除一个16位的单位范围。成功后， data和length反映了变化。
    
    参数
    
    offset - 要从中移除的偏移量。
    
    count - 要删除的16位单位数。如果offset和count的总和超过length那么从offset到数据结尾的所有16位单位都将被删除。
    
    异常
    
    DOMException - INDEX_SIZE_ERR：如果指定的offset为负值或大于offset中的16位单位data ，或指定的count为负值则count 。
    NO_MODIFICATION_ALLOWED_ERR：如果此节点是只读的，则引发。
  - replaceData
```
void replaceData(int offset,
                 int count,
                 String arg)
          throws DOMException
```
    用指定的字符串替换从指定的16位单位偏移开始的字符。
    
    参数
    
    offset - 开始替换的偏移量。
    
    count - 要替换的16位单位数。如果offset和count的总和超过了length ，则所有16位数据单元都被替换; （即，效果是一样的一个remove具有相同范围的方法调用，接着是append方法调用）。
    
    arg - 必须更换范围的 DOMString 。
    
    异常
    
    DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of 16-bit units in data, or if the specified count is negative.
    NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

Interface CharacterData

Field Summary

Fields inherited from interface org.w3c.dom.Node

方法摘要

Methods inherited from interface org.w3c.dom.Node

方法详细信息

getData

setData

getLength

substringData

appendData

insertData

deleteData

replaceData