compact2, compact3

org.w3c.dom

Interface Text

All Superinterfaces:

CharacterData， Node

All Known Subinterfaces:

CDATASection， Text

public interface Text
extends CharacterData

的 Text接口继承 CharacterData代表文本内容（称为 character data XML）的 Element或 Attr。如果里面有一个元素的含量没有标记，文本是包含在一个单一的对象实施 Text接口，是元素的唯一的孩子。如果有标记，它解析为信息项（元素、注释等）和 Text节点形式的子元素列表。

当一个文件是第一个可以通过DOM，只有每一个文本块Text节点。用户可以创建Text相邻节点表示一个给定的元素含量没有任何干预的标记，但应该意识到，没有办法在XML或HTML表示这些节点之间的分离，所以他们不会（一般）坚持DOM编辑会话之间。的Node.normalize()方法将任何相邻的Text对象为每个文本块的一个节点。

没有词汇的检查是一个Text节点的内容完成，根据它的位置在文件中，一些字符必须被转义字符引用序列化时使用；如字符“< &“如果文本内容的一部分是一个元素或一个属性，字符序列”] ] >“当部分一个元素的引号字符”或撇号字符时部分属性。

又见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	Method and Description
String	getWholeText() 返回所有文本节点 Text逻辑相邻的文本节点到该节点，连接在文档顺序。
boolean	isElementContentWhitespace() 返回是否该文本节点包含 element content whitespace，经常滥用“忽略空白”。
Text	replaceWholeText(String content) 用指定的文本替换当前节点的文本和所有逻辑上的相邻的文本节点。
Text	splitText(int offset) 打破这个节点为两节点在指定的 offset，两者保持树的兄弟姐妹。

Methods inherited from interface org.w3c.dom.CharacterData

appendData, deleteData, getData, getLength, insertData, replaceData, setData, substringData

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

方法详细信息

splitText

Text splitText(int offset)
        throws DOMException

打破这个节点为两节点在指定的 offset，两者保持树的兄弟姐妹。在被分裂，这个节点将包含所有内容到 offset点。同一类型的一个新的节点，其中包含的所有内容和 offset点后，返回。如果原始节点有一个父节点，则新的节点将被插入为原始节点的下一个兄弟姐妹。当 offset等于该节点的长度，新的节点没有数据。

参数

offset - 16位偏移的分裂，从 0。

结果

新的节点，与此节点相同的类型。

异常

DOMException - index_size_err：提出如果指定的偏移量为负或大于 data 16位单元数。
no_modification_allowed_err：如果这个节点是只读了。

isElementContentWhitespace

boolean isElementContentWhitespace()

返回是否该文本节点包含 element content whitespace，经常滥用“忽略空白”。文本节点确定含有元素内容中的空格中的文件加载或如果在使用 Document.normalizeDocument()发生验证。

从以下版本开始：

DOM级别3

getWholeText

String getWholeText()

返回所有文本节点 Text逻辑相邻的文本节点到该节点，连接在文档顺序。
for实例，在下面的例子中，包含“酒吧”返回“barfoo” Text节点 wholeText，而包含“foo”返回“barfoo” Text节点。

----- + +| 
 |----- + +/ \/ \/ ----- \ + ------- +|酒吧| |眼耳鼻喉科；|“----- ------- + / +||/ ----- \| foo |----- / \

图：bartextnode.wholetext值是“barfoo”

从以下版本开始：

DOM级别3

replaceWholeText

Text replaceWholeText(String content)
               throws DOMException

用指定的文本替换当前节点的文本和所有逻辑上的相邻的文本节点。所有逻辑上的相邻的文本节点被删除，包括当前节点，除非它是替换文本的收件人。

此方法返回接收替换文本的节点。返回的节点是：

• null，当文本替换为空字符串；
• 当前节点，除非当前节点是只读的；
• 同一类型的一个新的Text节点（Text或CDATASection）作为替代的位置插入到当前节点。

例如，在上面的例子中调用replaceWholeText在Text节点包含“酒吧”和“哟”争论的结果如下：

----- + +| 
 |----- + +||/ ----- \|哟|----- / \

图：bartextnode。replacewholetext（“你”）对bartextnode文本内容“哟”

在要删除的节点是一个EntityReference只读的后裔，EntityReference必须除去，而不是只读节点。如果有任何EntityReference被后人不EntityReference，Text，或CDATASection节点的replaceWholeText方法必须执行文件的任何修改失败之前，用代码NO_MODIFICATION_ALLOWED_ERR提高DOMException。

例如，在下面的例子中，包含“酒吧”失败的Text节点调用replaceWholeText，因为EntityReference节点“ENT”包含一个Element节点不能被删除。

参数

content -更换 Text节点的内容。

结果

使用指定的内容创建的 Text节点。

异常

DOMException - no_modification_allowed_err：如果一个节点的 Text被替换只读了。

从以下版本开始：

DOM级别3