-
- 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位为单位完成。
-
-
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 specifiedoffset
is negative or greater than the number of 16-bit units indata
, or if the specifiedcount
is negative.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
-
-