Most visited

Recently visited

Results for

Added in API level 1

Summary: Inherited Constants | Methods | Inherited Methods | [Expand All]

CharacterData

public interface CharacterData
implements Node

org.w3c.dom.CharacterData

Known Indirect Subclasses

CDATASection, Comment, Text

CharacterData接口使用一组用于访问DOM中字符数据的属性和方法来扩展Node。为了清楚起见，这里定义了这个集合，而不是每个使用这些属性和方法的对象。没有DOM对象直接对应于CharacterData ，尽管Text和其他人继承了它的接口。这个接口中的所有offsets从0开始。

正如DOMString接口中所解释的，DOM中的文本字符串以UTF-16表示，即以16位单元的序列表示。在下文中，术语16位单元在必要时用于指示在CharacterData上的索引是以16位为单位完成的。

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

摘要(Summary)

Inherited constants

From interface org.w3c.dom.Node

公共方法(Public methods)
`abstract void`	`appendData(String arg)` 将字符串追加到节点的字符数据的末尾。
`abstract void`	`deleteData(int offset, int count)` 从节点中删除一系列的16位单元。
`abstract String`	`getData()` 实现此接口的节点的字符数据。
`abstract int`	`getLength()` 通过 `data`和下面的 `substringData`方法可用的16位单元的数量。
`abstract void`	`insertData(int offset, String arg)` 以指定的16位单位偏移量插入一个字符串。
`abstract void`	`replaceData(int offset, int count, String arg)` 用指定的字符串替换从指定的16位单位偏移量开始的字符。
`abstract void`	`setData(String data)` 实现此接口的节点的字符数据。
`abstract String`	`substringData(int offset, int count)` 从节点中提取一系列数据。

继承方法(Inherited methods)

From interface org.w3c.dom.Node

`abstract Node`	`appendChild(Node newChild)` 将节点 `newChild`添加到此节点的子节点列表的末尾。
`abstract Node`	`cloneNode(boolean deep)` 返回此节点的副本，即充当节点的通用拷贝构造函数。
`abstract short`	`compareDocumentPosition(Node other)` 比较参考节点，即
`abstract NamedNodeMap`	`getAttributes()` 包含此节点的属性的 `NamedNodeMap` （如果它是 `Element` ）或 `null`否则。
`abstract String`	`getBaseURI()` 如果实现无法获取绝对URI，则此节点的绝对基本URI或 `null` 。
`abstract NodeList`	`getChildNodes()` 包含此节点的所有子节点的 `NodeList` 。
`abstract Object`	`getFeature(String feature, String version)` 此方法返回一个专用对象，该对象实现指定功能和版本的专用API，如中指定。
`abstract Node`	`getFirstChild()` 这个节点的第一个孩子。
`abstract Node`	`getLastChild()` 这个节点的最后一个孩子。
`abstract String`	`getLocalName()` 返回此节点的限定名称的本地部分。
`abstract String`	`getNamespaceURI()` 该节点的名称空间URI，如果未指定， `null` （请参阅 `null` ）。
`abstract Node`	`getNextSibling()` 节点紧跟在此节点之后。
`abstract String`	`getNodeName()` 该节点的名称取决于其类型; 见上表。
`abstract short`	`getNodeType()` 如上定义的代表底层对象类型的代码。
`abstract String`	`getNodeValue()` 此节点的值取决于其类型; 见上表。
`abstract Document`	`getOwnerDocument()` 与此节点关联的 `Document`对象。
`abstract Node`	`getParentNode()` 此节点的父节点。
`abstract String`	`getPrefix()` 该节点的名称空间前缀，如果未指定， `null` 。
`abstract Node`	`getPreviousSibling()` 该节点之前的节点。
`abstract String`	`getTextContent()` 该属性返回此节点及其后代的文本内容。
`abstract Object`	`getUserData(String key)` 检索与此节点上的键关联的对象。
`abstract boolean`	`hasAttributes()` 返回此节点（如果它是元素）是否具有任何属性。
`abstract boolean`	`hasChildNodes()` 返回此节点是否有任何子节点。
`abstract Node`	`insertBefore(Node newChild, Node refChild)` 插入节点 `newChild`现有的子节点之前 `refChild` 。
`abstract boolean`	`isDefaultNamespace(String namespaceURI)` 此方法检查指定的 `namespaceURI`是否为默认名称空间。
`abstract boolean`	`isEqualNode(Node arg)` 测试两个节点是否相等。
`abstract boolean`	`isSameNode(Node other)` 返回此节点是否与给定节点相同。
`abstract boolean`	`isSupported(String feature, String version)` 测试DOM实现是否实现了特定的功能，该功能是否受此节点支持，如指定。
`abstract String`	`lookupNamespaceURI(String prefix)` 从该节点开始查找与给定前缀关联的命名空间URI。
`abstract String`	`lookupPrefix(String namespaceURI)` 从该节点开始查找与给定名称空间URI关联的前缀。
`abstract void`	`normalize()` 将包含属性节点的此 `Node`下的子树的全部深度中的所有 `Text`节点置于“正常”形式，其中只有结构（例如元素，注释，处理指令，CDATA节和实体引用）将 `Text`节点的，即，既没有相邻 `Text`节点也不空 `Text`节点。
`abstract Node`	`removeChild(Node oldChild)` 从子项列表中删除由 `oldChild`指示的子节点，并将其返回。
`abstract Node`	`replaceChild(Node newChild, Node oldChild)` 替换子节点 `oldChild`与 `newChild`儿童的名单，并返回 `oldChild`节点。
`abstract void`	`setNodeValue(String nodeValue)` 此节点的值取决于其类型; 见上表。
`abstract void`	`setPrefix(String prefix)` 该节点的名称空间前缀，如果未指定， `null` 。
`abstract void`	`setTextContent(String textContent)` 该属性返回此节点及其后代的文本内容。
`abstract Object`	`setUserData(String key, Object data, UserDataHandler handler)` 将对象与此节点上的键相关联。

公共方法(Public methods)

appendData

Added in API level 1

void appendData (String arg)

将字符串追加到节点的字符数据的末尾。一旦成功， data提供访问指定的data和DOMString的级联。

参数(Parameters)
`arg`	`String`: The `DOMString` to append.

抛出异常(Throws)
`DOMException`	NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

deleteData

Added in API level 1

void deleteData (int offset, 
                int count)

从节点中删除一系列的16位单元。一旦成功， data和length反映了这一变化。

参数(Parameters)
`offset`	`int`: The offset from which to start removing.
`count`	`int`: The number of 16-bit units to delete. If the sum of `offset` and `count` exceeds `length` then all 16-bit units from `offset` to the end of the data are deleted.

抛出异常(Throws)
`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.

getData

Added in API level 1

String getData ()

实现此接口的节点的字符数据。 DOM实现可能不会对可能存储在CharacterData节点中的数据量施加任意限制。但是，实施限制可能意味着整个节点的数据可能不适合单个DOMString 。在这种情况下，用户可以拨打substringData来检索大小合适的数据。

返回(Returns)
`String`

抛出异常(Throws)
`DOMException`	DOMSTRING_SIZE_ERR: Raised when it would return more characters than fit in a `DOMString` variable on the implementation platform.

getLength

Added in API level 1

int getLength ()

通过data和下面的substringData方法可用的16位单元的数量。这可能具有零值，即CharacterData节点可能为空。

返回(Returns)
`int`

insertData

Added in API level 1

void insertData (int offset, 
                String arg)

以指定的16位单位偏移量插入一个字符串。

参数(Parameters)
`offset`	`int`: The character offset at which to insert.
`arg`	`String`: The `DOMString` to insert.

抛出异常(Throws)
`DOMException`	INDEX_SIZE_ERR: Raised if the specified `offset` is negative or greater than the number of 16-bit units in `data`. NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

replaceData

Added in API level 1

void replaceData (int offset, 
                int count, 
                String arg)

用指定的字符串替换从指定的16位单位偏移量开始的字符。

参数(Parameters)
`offset`	`int`: The offset from which to start replacing.
`count`	`int`: The number of 16-bit units to replace. If the sum of `offset` and `count` exceeds `length`, then all 16-bit units to the end of the data are replaced; (i.e., the effect is the same as a `remove` method call with the same range, followed by an `append` method invocation).
`arg`	`String`: The `DOMString` with which the range must be replaced.

抛出异常(Throws)
`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.

setData

Added in API level 1

void setData (String data)

参数(Parameters)
`data`	`String`

抛出异常(Throws)
`DOMException`	NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.

substringData

Added in API level 1

String substringData (int offset, 
                int count)

从节点中提取一系列数据。

参数(Parameters)
`offset`	`int`: Start offset of substring to extract.
`count`	`int`: The number of 16-bit units to extract.

返回(Returns)
`String`	The specified substring. If the sum of `offset` and `count` exceeds the `length`, then all 16-bit units to the end of the data are returned.

抛出异常(Throws)
`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. DOMSTRING_SIZE_ERR: Raised if the specified range of text does not fit into a `DOMString`.

Interfaces

Exceptions

Most visited

Recently visited

Results for

CharacterData

摘要(Summary)

Inherited constants

公共方法(Public methods)

继承方法(Inherited methods)

公共方法(Public methods)

appendData

deleteData

getData

getLength

insertData

replaceData

setData

substringData