所有类
|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
org.w3c.dom
接口 CharacterData
- 所有超级接口:
- Node
- 所有已知子接口:
- CDATASection, Comment, Text
-
public interface CharacterData
- extends Node
CharacterData
接口使用属性集合和用于访问 DOM 中字符数据的方法扩展节点。为了清楚起见,在这里定义此集合,而不是在使用这些属性和方法的每个对象上定义。任何 DOM 对象都不会直接对应于 CharacterData
,尽管 Text
和其他的对象是从它继承该接口的。此接口中的所有 offset
都从 0
开始。
如 DOMString
接口中所述,DOM 中的文本字符串以 UTF-16(即 16 位单元序列)表示。在下述情况下,每当需要指示以 16 位单元在 CharacterData 上进行索引时就使用术语 16 位单元。
另请参见 Document Object Model (DOM) Level 3 Core Specification。
字段摘要 |
---|
方法摘要 | |
---|---|
void |
appendData(String arg) 将字符串追加到节点的字符数据的结尾。 |
void |
deleteData(int offset, int count) 从该节点移除某个范围的 16 位单元。 |
String |
getData() 实现此接口的节点的字符数据。 |
int |
getLength() 通过下面的 data 和 substringData 方法可使用的 16 位单元数。 |
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) 从该节点提取某个范围的数据。 |
方法详细信息 |
---|
getData
String getData() throws DOMException
-
实现此接口的节点的字符数据。DOM 实现不可以任意限制可以存储在
CharacterData
节点中的数据量。不过,实现限制可能意味着全部的节点数据不可以适合单个DOMString
。在这种情况下,用户可以调用substringData
以适当大小的片段来检索数据。 -
-
- 抛出:
DOMException
- DOMSTRING_SIZE_ERR:当它返回的字符多于实现平台上的DOMString
变量中的字符时引发此异常。
setData
void setData(String data) throws DOMException
-
实现此接口的节点的字符数据。DOM 实现不可以任意限制可以存储在
CharacterData
节点中的数据量。不过,实现限制可能意味着全部的节点数据不可以适合单个DOMString
。在这种情况下,用户可以调用substringData
以适当大小的片段来检索数据。。 -
-
- 抛出:
DOMException
- NO_MODIFICATION_ALLOWED_ERR:节点为只读的时引发此异常。
getLength
int getLength()
-
通过下面的
data
和substringData
方法可使用的 16 位单元数。此数可能是值 0,即CharacterData
节点可以为空。 -
-
substringData
String substringData(int offset, int count) throws DOMException
- 从该节点提取某个范围的数据。
-
-
- 参数:
offset
- 要提取的子字符串的起始偏移量。count
- 要提取的 16 位单元数。- 返回:
-
指定的子字符串。如果
offset
和count
的和超过length
,则返回到数据结尾处的所有 16 位单元。 - 抛出:
DOMException
- INDEX_SIZE_ERR:如果指定offset
为负或大于data
中的 16 位单元数,或者如果指定count
为负,则引发此异常。
DOMSTRING_SIZE_ERR:指定范围的文本不适合DOMString
时引发此异常。
appendData
void appendData(String arg) throws DOMException
-
将字符串追加到节点的字符数据的结尾。如果成功,则
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
为负或大于data
中的 16 位单元数时引发此异常。
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
为负或大于data
中的 16 位单元数,或者如果指定count
为负,则引发此异常。
NO_MODIFICATION_ALLOWED_ERR:如果此节点为只读的引发此异常。