mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-08 02:32:46 +08:00
261 lines
19 KiB
HTML
261 lines
19 KiB
HTML
<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>例如字符“<&”,如果文本内容是元素或属性的一部分,字符序列“]]>”当元素的一部分,引号字符或撇号字符“当属性的一部分时。</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>+-----+
|
||
| <p> |
|
||
+-----+
|
||
/\
|
||
/ \
|
||
/-----\ +-------+
|
||
| bar | | &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>+-----+
|
||
| <p> |
|
||
+-----+
|
||
|
|
||
|
|
||
/-----\
|
||
| 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> |