mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-07 18:22:57 +08:00
392 lines
19 KiB
HTML
392 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 NamedNodeMap">Interface NamedNodeMap</h2>
|
||
</div><div class="contentContainer">
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<hr/> <br/> <pre>public interface <span class="typeNameLabel">NamedNodeMap</span></pre>
|
||
<div class="block">
|
||
<span>实现<code>NamedNodeMap</code>接口的对象用于表示可以通过名称访问的节点集合。</span>
|
||
<span>请注意， <code>NamedNodeMap</code>不继承<code>NodeList</code> ;</span>
|
||
<span><code>NamedNodeMaps</code>未按任何特定顺序进行维护。</span>
|
||
<span>包含在实现一个对象的对象<code>NamedNodeMap</code>还可以通过一个顺序索引访问，但是这仅仅是允许的内容方便枚举<code>NamedNodeMap</code> ，并不意味着DOM指定的顺序对这些节点。</span>
|
||
<p> <span><code>NamedNodeMap</code> DOM中的对象是活的。</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">
|
||
<!-- ========== 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>int</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/NamedNodeMap.html#getLength--">getLength</a></span>()</code>
|
||
<div class="block">
|
||
该地图中的节点数。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/NamedNodeMap.html#getNamedItem-java.lang.String-">getNamedItem</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
|
||
<div class="block">
|
||
检索由name指定的节点。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/NamedNodeMap.html#getNamedItemNS-java.lang.String-java.lang.String-">getNamedItemNS</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName)</code>
|
||
<div class="block">
|
||
检索由本地名称和命名空间URI指定的节点。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/NamedNodeMap.html#item-int-">item</a></span>(int index)</code>
|
||
<div class="block">
|
||
返回地图中的
|
||
<code>index</code>项目。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i4">
|
||
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/NamedNodeMap.html#removeNamedItem-java.lang.String-">removeNamedItem</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
|
||
<div class="block">
|
||
删除由name指定的节点。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i5">
|
||
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/NamedNodeMap.html#removeNamedItemNS-java.lang.String-java.lang.String-">removeNamedItemNS</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName)</code>
|
||
<div class="block">
|
||
删除由本地名称和命名空间URI指定的节点。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i6">
|
||
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/NamedNodeMap.html#setNamedItem-org.w3c.dom.Node-">setNamedItem</a></span>(<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> arg)</code>
|
||
<div class="block">
|
||
使用其
|
||
<code>nodeName</code>属性添加节点。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i7">
|
||
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/NamedNodeMap.html#setNamedItemNS-org.w3c.dom.Node-">setNamedItemNS</a></span>(<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> arg)</code>
|
||
<div class="block">
|
||
使用其
|
||
<code>namespaceURI</code>和
|
||
<code>localName</code>添加节点。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table> </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="getNamedItem-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getNamedItem</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> getNamedItem(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</pre>
|
||
<div class="block">
|
||
检索由name指定的节点。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>name</code> - 要检索的节点的
|
||
<code>nodeName</code> 。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
A
|
||
<code>Node</code> （任何类型的），具有指定的
|
||
<code>nodeName</code> ，或
|
||
<code>null</code>如果它不标识此映射中的任何节点。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="setNamedItem-org.w3c.dom.Node-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setNamedItem</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> setNamedItem(<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> arg)
|
||
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
|
||
<div class="block">
|
||
<span>使用其<code>nodeName</code>属性添加节点。</span>
|
||
<span>如果具有该名称的节点已经存在于该映射中，则会被新映射替换。</span>
|
||
<span>自行替换节点不起作用。</span>
|
||
<br/>
|
||
<span>由于<code>nodeName</code>属性用于派生节点必须存储的名称，某些类型的多个节点（具有“特殊”字符串值的节点）不能存储，因为这些名称将会冲突。</span>
|
||
<span>这被认为优于允许节点被别名。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>arg</code> - 存储在此地图中的节点。</span>
|
||
<span>以后可以使用其<code>nodeName</code>属性的值访问该节点。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
如果新
|
||
<code>Node</code>替换替换现有节点
|
||
<code>Node</code>返回，否则
|
||
<code>null</code>返回。
|
||
</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> - WRONG_DOCUMENT_ERR：如果<code>arg</code>是从与创建此地图的文档不同的文档创建的。</span>
|
||
<br/>
|
||
<span>NO_MODIFICATION_ALLOWED_ERR：如果此地图是只读的，则提高。</span>
|
||
<br/>
|
||
<span>INUSE_ATTRIBUTE_ERR：如果<code>arg</code>是已经是另一个<code>Element</code>对象的属性的<code>Attr</code> ，则<code>Element</code> 。</span>
|
||
<span>DOM用户必须明确克隆<code>Attr</code>节点，以便在其他元素中重新使用它们。</span>
|
||
<br/>
|
||
<span>HIERARCHY_REQUEST_ERR：如果尝试添加节点不属于此NamedNodeMap，则引发。</span>
|
||
<span>示例将包括尝试将Attr节点以外的其他东西插入到元素的属性图中，或将非实体节点插入到DocumentType的Entities映射中。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="removeNamedItem-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>removeNamedItem</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> removeNamedItem(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)
|
||
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
|
||
<div class="block">
|
||
<span>删除由name指定的节点。</span>
|
||
<span>当此映射包含附加到元素的属性时，如果已知已删除的属性具有默认值，则属性会立即显示，其中包含默认值以及相应的命名空间URI，本地名称和前缀（如果适用）。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>name</code> - 要删除的节点的
|
||
<code>nodeName</code> 。
|
||
</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> - NOT_FOUND_ERR：如果此映射中没有名为<code>name</code>的节点，则引发。</span>
|
||
<br/>
|
||
<span>NO_MODIFICATION_ALLOWED_ERR：如果此地图是只读的，则提高。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="item-int-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>item</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> item(int index)</pre>
|
||
<div class="block">
|
||
<span>返回地图中的<code>index</code>项目。</span>
|
||
<span>如果<code>index</code>大于或等于此映射中的节点数，则返回<code>null</code> 。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>index</code> - 索引到此地图。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
该节点在地图上的
|
||
<code>index</code>位置，或
|
||
<code>null</code>如果不是有效索引。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getLength--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getLength</h4> <pre>int getLength()</pre>
|
||
<div class="block">
|
||
<span>该地图中的节点数。</span>
|
||
<span>有效子节点索引的范围为<code>0</code>至<code>length-1</code>含）。</span>
|
||
</div> </li>
|
||
</ul> <a name="getNamedItemNS-java.lang.String-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getNamedItemNS</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> getNamedItemNS(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI,
|
||
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName)
|
||
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
|
||
<div class="block">
|
||
<span>检索由本地名称和命名空间URI指定的节点。</span>
|
||
<br/>
|
||
<span>按照[ <a href="http://www.w3.org/TR/1999/REC-xml-names-19990114/">XML Namespaces</a> ]，应用程序必须使用值null作为方法的namespaceURI参数，如果他们希望没有命名空间。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>namespaceURI</code> - 要检索的节点的命名空间URI。
|
||
</dd>
|
||
<dd>
|
||
<code>localName</code> - 要检索的节点的本地名称。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
具有指定的本地名称和命名空间URI的
|
||
<code>Node</code> （任何类型的），如果它们不标识此映射中的任何节点，
|
||
<code>null</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> - NOT_SUPPORTED_ERR：如果实现不支持功能“XML”，并且通过文档公开的语言不支持XML命名空间（例如[
|
||
<a href="http://www.w3.org/TR/1999/REC-html401-19991224/">HTML 4.01</a> ]），则可能会被引发。
|
||
</dd>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始：</span>
|
||
</dt>
|
||
<dd>
|
||
DOM级别2
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="setNamedItemNS-org.w3c.dom.Node-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setNamedItemNS</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> setNamedItemNS(<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> arg)
|
||
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
|
||
<div class="block">
|
||
<span>使用其<code>namespaceURI</code>和<code>localName</code>添加节点。</span>
|
||
<span>如果具有该名称空间URI和该本地名称的节点已经存在于该映射中，则该节点将被新映射替换。</span>
|
||
<span>自行替换节点不起作用。</span>
|
||
<br/>
|
||
<span>Per [ <a href="http://www.w3.org/TR/1999/REC-xml-names-19990114/">XML Namespaces</a> ]，应用程序必须使用值null作为方法的namespaceURI参数，如果他们希望没有命名空间。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>arg</code> - 存储在此地图中的节点。</span>
|
||
<span>稍后可以使用其<code>namespaceURI</code>和<code>localName</code>属性的值访问该节点。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
如果新
|
||
<code>Node</code>替换替换现有节点
|
||
<code>Node</code>返回，否则
|
||
<code>null</code>返回。
|
||
</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> - WRONG_DOCUMENT_ERR：如果<code>arg</code>是从与创建该地图的文档不同的文档创建的。</span>
|
||
<br/>
|
||
<span>NO_MODIFICATION_ALLOWED_ERR：如果此地图是只读的，则提高。</span>
|
||
<br/>
|
||
<span>INUSE_ATTRIBUTE_ERR：如果<code>arg</code>是已经是另一个<code>Element</code>对象的属性的<code>Attr</code> ，则<code>Element</code> 。</span>
|
||
<span>DOM用户必须明确克隆<code>Attr</code>节点，以便在其他元素中重新使用它们。</span>
|
||
<br/>
|
||
<span>HIERARCHY_REQUEST_ERR：如果尝试添加节点不属于此NamedNodeMap，则引发。</span>
|
||
<span>示例将包括尝试将Attr节点以外的其他东西插入到元素的属性图中，或将非实体节点插入到DocumentType的Entities映射中。</span>
|
||
<br/>
|
||
<span>NOT_SUPPORTED_ERR：如果实现不支持功能“XML”，并且通过文档公开的语言不支持XML命名空间（例如[ <a href="http://www.w3.org/TR/1999/REC-html401-19991224/">HTML 4.01</a> ]），则可能会被引发。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始：</span>
|
||
</dt>
|
||
<dd>
|
||
DOM级别2
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="removeNamedItemNS-java.lang.String-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>removeNamedItemNS</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> removeNamedItemNS(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI,
|
||
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName)
|
||
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
|
||
<div class="block">
|
||
<span>删除由本地名称和命名空间URI指定的节点。</span>
|
||
<span>当此映射包含附加到元素的属性（如Node接口的<code>Node</code>属性返回）时，已知删除的属性可能具有默认值。</span>
|
||
<span>如果是这样，属性会立即出现，包含默认值以及相应的命名空间URI，本地名称和前缀（如果适用）。</span>
|
||
<br/>
|
||
<span>按照[ <a href="http://www.w3.org/TR/1999/REC-xml-names-19990114/">XML Namespaces</a> ]，应用程序必须使用值null作为方法的namespaceURI参数，如果他们希望没有命名空间。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>namespaceURI</code> - 要删除的节点的命名空间URI。
|
||
</dd>
|
||
<dd>
|
||
<code>localName</code> - 要删除的节点的本地名称。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
如果具有这样的本地名称和命名空间URI的节点存在，则从该映射中删除该节点。
|
||
</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> - NOT_FOUND_ERR：如果此地图中没有指定的<code>namespaceURI</code>和<code>localName</code>节点，则将其提升。</span>
|
||
<br/>
|
||
<span>NO_MODIFICATION_ALLOWED_ERR：如果此地图是只读的，则提高。</span>
|
||
<br/>
|
||
<span>NOT_SUPPORTED_ERR：如果实现不支持功能“XML”，并且通过文档公开的语言不支持XML命名空间（例如[ <a href="http://www.w3.org/TR/1999/REC-html401-19991224/">HTML 4.01</a> ]），则可能会被引发。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始：</span>
|
||
</dt>
|
||
<dd>
|
||
DOM级别2
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |