261 lines
19 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
compact2, compact3
</div>
<div class="subTitle">
org.w3c.dom
</div>
<h2 class="title" title="Interface Text">Interface Text</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Superinterfaces:
</dt>
<dd>
<span><a href="../../../org/w3c/dom/CharacterData.html" title="界面在org.w3c.dom">CharacterData</a> <a href="../../../org/w3c/dom/Node.html" title="界面在org.w3c.dom">Node</a></span>
</dd>
</dl>
<dl>
<dt>
All Known Subinterfaces:
</dt>
<dd>
<span><a href="../../../org/w3c/dom/CDATASection.html" title="界面在org.w3c.dom">CDATASection</a> <a href="../../../javax/xml/soap/Text.html" title="javax.xml.soap中的接口">Text</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">Text</span>
extends <a href="../../../org/w3c/dom/CharacterData.html" title="interface in org.w3c.dom">CharacterData</a></pre>
<div class="block">
<span>所述<code>Text</code>接口从继承<code>CharacterData</code>和表示文本内容(称为<a href="http://www.w3.org/TR/2004/REC-xml-20040204#syntax">character data</a>一个在XML <code>Element</code><code>Attr</code></span>
<span>如果元素内容中没有标记则该文本包含在实现Text接口的单个对象中<code>Text</code>是该元素的唯一子元素。</span>
<span>如果有标记,则将其分解为形成元素子元素列表的信息项(元素,注释等)和<code>Text</code>节点。</span>
<p> <span>当文档首先通过DOM <code>Text</code> ,每个文本块只有一个<code>Text</code>节点。</span> <span>用户可以创建表示给定元素的内容的邻近的<code>Text</code>节点而不需要任何中间标记但是应该意识到无法在XML或HTML中表示这些节点之间的分离因此它们不会通常在DOM编辑会话。</span> <span><code>Node.normalize()</code>方法将任何此类相邻的<code>Text</code>对象合并到每个文本块的单个节点中。</span> </p>
<p> <span>没有对<code>Text</code>节点的内容进行词法检查,根据文档的位置,在使用字符引用的序列化过程中必须转义一些字符;</span> <span>例如字符“&lt;&”,如果文本内容是元素或属性的一部分,字符序列“]]&gt;”当元素的一部分,引号字符或撇号字符“当属性的一部分时。</span> </p>
<p> <span>另见<a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407">Document Object Model (DOM) Level 3 Core Specification</a></span> </p>
</div> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- --> </a> <h3>Field Summary</h3>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.org.w3c.dom.Node">
<!-- --> </a> <h3>Fields inherited from interface org.w3c.dom.<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></h3> <code><a href="../../../org/w3c/dom/Node.html#ATTRIBUTE_NODE">ATTRIBUTE_NODE</a>, <a href="../../../org/w3c/dom/Node.html#CDATA_SECTION_NODE">CDATA_SECTION_NODE</a>, <a href="../../../org/w3c/dom/Node.html#COMMENT_NODE">COMMENT_NODE</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_FRAGMENT_NODE">DOCUMENT_FRAGMENT_NODE</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_NODE">DOCUMENT_NODE</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_CONTAINED_BY">DOCUMENT_POSITION_CONTAINED_BY</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_CONTAINS">DOCUMENT_POSITION_CONTAINS</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_DISCONNECTED">DOCUMENT_POSITION_DISCONNECTED</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_FOLLOWING">DOCUMENT_POSITION_FOLLOWING</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC">DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_PRECEDING">DOCUMENT_POSITION_PRECEDING</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_TYPE_NODE">DOCUMENT_TYPE_NODE</a>, <a href="../../../org/w3c/dom/Node.html#ELEMENT_NODE">ELEMENT_NODE</a>, <a href="../../../org/w3c/dom/Node.html#ENTITY_NODE">ENTITY_NODE</a>, <a href="../../../org/w3c/dom/Node.html#ENTITY_REFERENCE_NODE">ENTITY_REFERENCE_NODE</a>, <a href="../../../org/w3c/dom/Node.html#NOTATION_NODE">NOTATION_NODE</a>, <a href="../../../org/w3c/dom/Node.html#PROCESSING_INSTRUCTION_NODE">PROCESSING_INSTRUCTION_NODE</a>, <a href="../../../org/w3c/dom/Node.html#TEXT_NODE">TEXT_NODE</a></code></li>
</ul> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Text.html#getWholeText--">getWholeText</a></span>()</code>
<div class="block">
返回
<code>Text</code>节点的逻辑相邻文本节点的所有文本到此节点,以文档顺序连接。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Text.html#isElementContentWhitespace--">isElementContentWhitespace</a></span>()</code>
<div class="block">
返回此文本节点是否包含
<a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204#infoitem.character">element content whitespace</a> ,经常被称为“可忽略的空白”。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Text.html" title="interface in org.w3c.dom">Text</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Text.html#replaceWholeText-java.lang.String-">replaceWholeText</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> content)</code>
<div class="block">
用指定的文本替换当前节点和所有逻辑上相邻的文本节点的文本。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Text.html" title="interface in org.w3c.dom">Text</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Text.html#splitText-int-">splitText</a></span>(int offset)</code>
<div class="block">
将此节点拆分两个节点在指定的
<code>offset</code> ,无论是在树中的兄弟姐妹是一致的。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.w3c.dom.CharacterData">
<!-- --> </a> <h3>Methods inherited from interface org.w3c.dom.<a href="../../../org/w3c/dom/CharacterData.html" title="interface in org.w3c.dom">CharacterData</a></h3> <code><a href="../../../org/w3c/dom/CharacterData.html#appendData-java.lang.String-">appendData</a>, <a href="../../../org/w3c/dom/CharacterData.html#deleteData-int-int-">deleteData</a>, <a href="../../../org/w3c/dom/CharacterData.html#getData--">getData</a>, <a href="../../../org/w3c/dom/CharacterData.html#getLength--">getLength</a>, <a href="../../../org/w3c/dom/CharacterData.html#insertData-int-java.lang.String-">insertData</a>, <a href="../../../org/w3c/dom/CharacterData.html#replaceData-int-int-java.lang.String-">replaceData</a>, <a href="../../../org/w3c/dom/CharacterData.html#setData-java.lang.String-">setData</a>, <a href="../../../org/w3c/dom/CharacterData.html#substringData-int-int-">substringData</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.w3c.dom.Node">
<!-- --> </a> <h3>Methods inherited from interface org.w3c.dom.<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></h3> <code><a href="../../../org/w3c/dom/Node.html#appendChild-org.w3c.dom.Node-">appendChild</a>, <a href="../../../org/w3c/dom/Node.html#cloneNode-boolean-">cloneNode</a>, <a href="../../../org/w3c/dom/Node.html#compareDocumentPosition-org.w3c.dom.Node-">compareDocumentPosition</a>, <a href="../../../org/w3c/dom/Node.html#getAttributes--">getAttributes</a>, <a href="../../../org/w3c/dom/Node.html#getBaseURI--">getBaseURI</a>, <a href="../../../org/w3c/dom/Node.html#getChildNodes--">getChildNodes</a>, <a href="../../../org/w3c/dom/Node.html#getFeature-java.lang.String-java.lang.String-">getFeature</a>, <a href="../../../org/w3c/dom/Node.html#getFirstChild--">getFirstChild</a>, <a href="../../../org/w3c/dom/Node.html#getLastChild--">getLastChild</a>, <a href="../../../org/w3c/dom/Node.html#getLocalName--">getLocalName</a>, <a href="../../../org/w3c/dom/Node.html#getNamespaceURI--">getNamespaceURI</a>, <a href="../../../org/w3c/dom/Node.html#getNextSibling--">getNextSibling</a>, <a href="../../../org/w3c/dom/Node.html#getNodeName--">getNodeName</a>, <a href="../../../org/w3c/dom/Node.html#getNodeType--">getNodeType</a>, <a href="../../../org/w3c/dom/Node.html#getNodeValue--">getNodeValue</a>, <a href="../../../org/w3c/dom/Node.html#getOwnerDocument--">getOwnerDocument</a>, <a href="../../../org/w3c/dom/Node.html#getParentNode--">getParentNode</a>, <a href="../../../org/w3c/dom/Node.html#getPrefix--">getPrefix</a>, <a href="../../../org/w3c/dom/Node.html#getPreviousSibling--">getPreviousSibling</a>, <a href="../../../org/w3c/dom/Node.html#getTextContent--">getTextContent</a>, <a href="../../../org/w3c/dom/Node.html#getUserData-java.lang.String-">getUserData</a>, <a href="../../../org/w3c/dom/Node.html#hasAttributes--">hasAttributes</a>, <a href="../../../org/w3c/dom/Node.html#hasChildNodes--">hasChildNodes</a>, <a href="../../../org/w3c/dom/Node.html#insertBefore-org.w3c.dom.Node-org.w3c.dom.Node-">insertBefore</a>, <a href="../../../org/w3c/dom/Node.html#isDefaultNamespace-java.lang.String-">isDefaultNamespace</a>, <a href="../../../org/w3c/dom/Node.html#isEqualNode-org.w3c.dom.Node-">isEqualNode</a>, <a href="../../../org/w3c/dom/Node.html#isSameNode-org.w3c.dom.Node-">isSameNode</a>, <a href="../../../org/w3c/dom/Node.html#isSupported-java.lang.String-java.lang.String-">isSupported</a>, <a href="../../../org/w3c/dom/Node.html#lookupNamespaceURI-java.lang.String-">lookupNamespaceURI</a>, <a href="../../../org/w3c/dom/Node.html#lookupPrefix-java.lang.String-">lookupPrefix</a>, <a href="../../../org/w3c/dom/Node.html#normalize--">normalize</a>, <a href="../../../org/w3c/dom/Node.html#removeChild-org.w3c.dom.Node-">removeChild</a>, <a href="../../../org/w3c/dom/Node.html#replaceChild-org.w3c.dom.Node-org.w3c.dom.Node-">replaceChild</a>, <a href="../../../org/w3c/dom/Node.html#setNodeValue-java.lang.String-">setNodeValue</a>, <a href="../../../org/w3c/dom/Node.html#setPrefix-java.lang.String-">setPrefix</a>, <a href="../../../org/w3c/dom/Node.html#setTextContent-java.lang.String-">setTextContent</a>, <a href="../../../org/w3c/dom/Node.html#setUserData-java.lang.String-java.lang.Object-org.w3c.dom.UserDataHandler-">setUserData</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="splitText-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>splitText</h4> <pre><a href="../../../org/w3c/dom/Text.html" title="interface in org.w3c.dom">Text</a> splitText(int offset)
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>将该节点分解成指定的<code>offset</code>两个节点,保持树中的兄弟姐妹。</span>
<span>分裂后,此节点将包含所有内容,直到<code>offset</code>点。</span>
<span>返回相同类型的新节点,其中包含<code>offset</code>点之后的所有内容。</span>
<span>如果原始节点具有父节点,则将新节点作为原始节点的下一个兄弟节点插入。</span>
<span><code>offset</code>等于该节点的长度时,新节点没有数据。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>offset</code> - 从
<code>0</code>开始的16位单位偏移量。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
新节点,与该节点的类型相同。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - INDEX_SIZE_ERR如果指定的偏移量为负或大于data中的16位单元数<code>data</code></span>
<br/>
<span>NO_MODIFICATION_ALLOWED_ERR如果此节点是只读的则引发。</span>
</dd>
</dl> </li>
</ul> <a name="isElementContentWhitespace--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isElementContentWhitespace</h4> <pre>boolean isElementContentWhitespace()</pre>
<div class="block">
<span>返回此文本节点是否包含<a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204#infoitem.character">element content whitespace</a> ,经常被称为“可忽略的空白”。</span>
<span>在文档加载期间,文本节点被确定为在元素内容中包含空格,或者如果在使用<code>Document.normalizeDocument()</code>时发生<code>Document.normalizeDocument()</code></span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
DOM 3级
</dd>
</dl> </li>
</ul> <a name="getWholeText--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getWholeText</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getWholeText()</pre>
<div class="block">
<span>返回<code>Text</code>节点逻辑相邻的文本节点到此节点的所有文本,以文档顺序连接。</span>
<br/>
<span>例如,在下面的例子中<code>wholeText</code>的上<code>Text</code>包含“栏中的”返回“barfoo”而在节点<code>Text</code>包含节点“foo”的则返回“barfoo”。</span>
<pre> <span>+-----+
| &lt;p&gt; |
+-----+
/\
/ \
/-----\ +-------+
| bar | | &amp;ent; |
\-----/ +-------+
|
|
/-----\
| foo |
\-----/</span> </pre>
<span><em>barTextNode.wholeText值是“barfoo”</em></span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
DOM 3级
</dd>
</dl> </li>
</ul> <a name="replaceWholeText-java.lang.String-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>replaceWholeText</h4> <pre><a href="../../../org/w3c/dom/Text.html" title="interface in org.w3c.dom">Text</a> replaceWholeText(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> content)
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>用指定的文本替换当前节点和所有逻辑上相邻的文本节点的文本。</span>
<span>删除所有逻辑上相邻的文本节点,包括当前节点,除非它是替换文本的接收者。</span>
<p> <span>此方法返回接收替换文本的节点。</span> <span>返回的节点是:</span> </p>
<ul>
<li> <span><code>null</code> ,当替换文本为空字符串时;</span> </li>
<li> <span>当前节点,当前节点为只读时除外;</span> </li>
<li> <span>与当前节点插入替换位置的新型<code>Text</code>节点( <code>Text</code><code>CDATASection</code> )相同。</span> </li>
</ul>
<p> <span>例如,在上面的例子中,在<code>Text</code>节点上调用<code>replaceWholeText</code>节点其中包含“bar”和“yo”在参数中的结果如下</span> </p>
<pre> <span>+-----+
| &lt;p&gt; |
+-----+
|
|
/-----\
| yo |
\-----/</span> </pre>
<span><em>barTextNode.replaceWholeText“yo”用“yo”修改barTextNode的文本内容</em></span>
<p> <span>要删除的节点是EntityReference的只读<code>EntityReference</code> ,必须删除<code>EntityReference</code>而不是只读节点。</span> <span>如果任何<code>EntityReference</code>要去除具有不后代<code>EntityReference</code> <code>Text</code> ,或<code>CDATASection</code>节点,所述<code>replaceWholeText</code>方法必须在执行该文件的任何修改,养之前失败<code>DOMException</code>与代码<code>NO_MODIFICATION_ALLOWED_ERR</code></span> </p>
<p> <span>例如在下面的示例中在包含“bar”的<code>Text</code>节点上调用<code>replaceWholeText</code>失败,因为<code>EntityReference</code>节点“ent”包含无法删除的<code>Element</code>节点。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>content</code> - 替换
<code>Text</code>节点的内容。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
用指定内容创建的
<code>Text</code>节点。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - NO_MODIFICATION_ALLOWED_ERR如果正在替换的
<code>Text</code>节点中的一个被显示为
<code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> ,则会引发。
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
DOM 3级
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>