mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-07 18:22:57 +08:00
555 lines
25 KiB
HTML
555 lines
25 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
compact2, compact3
|
||
</div>
|
||
<div class="subTitle">
|
||
org.w3c.dom
|
||
</div>
|
||
<h2 class="title" title="Interface DOMConfiguration">Interface DOMConfiguration</h2>
|
||
</div><div class="contentContainer">
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<hr/> <br/> <pre>public interface <span class="typeNameLabel">DOMConfiguration</span></pre>
|
||
<div class="block">
|
||
<span><code>DOMConfiguration</code>接口表示文档的配置,并维护已识别参数的表。</span>
|
||
<span>使用上述结构,能够改变<code>Document.normalizeDocument()</code>行为,如更换<code>CDATASection</code>与节点<code>Text</code>节点或指定的验证时必须使用的模式的类型<code>Document</code>被请求。</span>
|
||
<span><code>DOMConfiguration</code>对象也在<code>DOMParser</code>和<code>DOMSerializer</code>接口中的[ <a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407">DOM Level 3 Load and Save</a> ]中使用。</span>
|
||
<p> <span><code>DOMConfiguration</code>对象使用的参数名称在DOM Level 3规范中定义。</span> <span>名称不区分大小写。</span> <span>为了避免可能的冲突,作为惯例,引用在DOM规范之外定义的参数的名称应该是唯一的。</span> <span>因为参数是公开的,因为名称中的属性建议遵循5.16标识符[Unicode],添加字符' - '(HYPHEN-MINUS),但不被DOM实现强制执行。</span> <span>DOM 3级核心实现需要识别本规范中定义的所有参数。</span> <span>某些参数值也可能需要由实现支持。</span> <span>参考参数的定义来知道是否必须支持一个值。</span> </p>
|
||
<p> <span><b>注意:</b>参数与SAX2 [ <a href="http://www.saxproject.org/">SAX</a> ]中使用的特征和属性相似。</span> </p>
|
||
<p> <span>DOM中定义的以下参数列表:</span> </p>
|
||
<dl>
|
||
<dt>
|
||
<code>"canonical-form"</code>
|
||
</dt>
|
||
<dd>
|
||
<dl>
|
||
<dt>
|
||
<code>true</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>可选</em> ]根据[ <a href="http://www.w3.org/TR/2001/REC-xml-c14n-20010315">Canonical XML</a> ]中规定的规则规范文档,例如从树中删除<code>DocumentType</code>节点(如果有),或从每个元素中删除多余的命名空间声明。</span>
|
||
<span>请注意,这仅限于DOM中可以表示的内容;</span>
|
||
<span>特别是没有办法在DOM中指定属性的顺序。</span>
|
||
<span>此外,将此参数设置为<code>true</code>还将设置下列参数的状态。</span>
|
||
<span>之后对其中一个参数的更改将会将“规范形式”恢复为<code>false</code> 。</span>
|
||
<span>参数设置为<code>false</code> :“entities”,“normalize-characters”,“cdata-sections”。</span>
|
||
<span>参数设置为<code>true</code> :“namespaces”,“namespace-declaration”,“well-formed”,“element-content-whitespace”。</span>
|
||
<span>除非在参数说明中明确指定,否则其他参数不会更改。</span>
|
||
</dd>
|
||
<dt>
|
||
<code>false</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>必需</em> ]( <em>默认</em> )不要规范化文档。</span>
|
||
</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt>
|
||
<code>"cdata-sections"</code>
|
||
</dt>
|
||
<dd>
|
||
<dl>
|
||
<dt>
|
||
<code>true</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>必需</em> ]( <em>默认</em> )在文档中保留<code>CDATASection</code>个节点。</span>
|
||
</dd>
|
||
<dt>
|
||
<code>false</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>需要</em> ]变换<code>CDATASection</code>的文档中的节点到<code>Text</code>节点。</span>
|
||
<span>然后将新的<code>Text</code>节点与任何相邻的<code>Text</code>节点组合。</span>
|
||
</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt>
|
||
<code>"check-character-normalization"</code>
|
||
</dt>
|
||
<dd>
|
||
<dl>
|
||
<dt>
|
||
<code>true</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>可选</em> ]根据[ <a href="http://www.w3.org/TR/2004/REC-xml11-20040204/">XML 1.1</a> ]附录B的定义,检查文档中的<a href="http://www.w3.org/TR/2004/REC-xml11-20040204/#dt-fullnorm">字符是否</a>为<a href="http://www.w3.org/TR/2004/REC-xml11-20040204/">fully normalized</a> 。</span>
|
||
<span>当遇到无法正常化检查的字符序列时,发出<code>DOMError.type</code>等于“检查字符归一化失败”的错误。</span>
|
||
</dd>
|
||
<dt>
|
||
<code>false</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>必需</em> ]( <em>默认</em> )不检查字符是否正常化。</span>
|
||
</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt>
|
||
<code>"comments"</code>
|
||
</dt>
|
||
<dd>
|
||
<dl>
|
||
<dt>
|
||
<code>true</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>必需</em> ]( <em>默认</em> )在文档中保留<code>Comment</code>个节点。</span>
|
||
</dd>
|
||
<dt>
|
||
<code>false</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>required</em> ]放弃文档中的<code>Comment</code>节点。</span>
|
||
</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt>
|
||
<code>"datatype-normalization"</code>
|
||
</dt>
|
||
<dd>
|
||
<dl>
|
||
<dt>
|
||
<code>true</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>可选</em> ]在树中公开模式归一化值,例如在XML Schema的情况下为<a href="http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/#key-nv">XML Schema normalized values</a> 。</span>
|
||
<span>由于此参数需要具有模式信息,因此“validate”参数也将设置为<code>true</code> 。</span>
|
||
<span>有了这个参数启动时“验证”是<code>false</code>没有效果,没有模式规范化会发生。</span>
|
||
<p> <span><b>注意:</b>由于文档包含XML 1.0处理的结果,该参数不适用于[ <a href="http://www.w3.org/TR/2004/REC-xml-20040204">XML 1.0</a> ] 3.3.3节中定义的属性值归一化,仅适用于文档类型定义(DTD)以外的模式语言。</span> </p>
|
||
</dd>
|
||
<dt>
|
||
<code>false</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>必需</em> ]( <em>默认</em> )不要在树上执行模式归一化。</span>
|
||
</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt>
|
||
<code>"element-content-whitespace"</code>
|
||
</dt>
|
||
<dd>
|
||
<dl>
|
||
<dt>
|
||
<code>true</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>必需</em> ]( <em>默认</em> )将所有空格保留在文档中。</span>
|
||
</dd>
|
||
<dt>
|
||
<code>false</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>可选</em> ]丢弃所有<code>Text</code>包含空格中元素的含量,如在描述的节点是<a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204#infoitem.character">[element content whitespace]</a> 。</span>
|
||
<span>预期该实现将使用属性<code>Text.isElementContentWhitespace</code>来确定<code>Text</code>节点是否应被丢弃。</span>
|
||
</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt>
|
||
<code>"entities"</code>
|
||
</dt>
|
||
<dd>
|
||
<dl>
|
||
<dt>
|
||
<code>true</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>必需</em> ]( <em>默认</em> )在文档中保留<code>EntityReference</code>个节点。</span>
|
||
</dd>
|
||
<dt>
|
||
<code>false</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>必需</em> ]从文档中删除所有<code>EntityReference</code>个节点,将实体扩展直接放在其位置。</span>
|
||
<span><code>Text</code>节点是归一化的,如在限定的<code>Node.normalize</code> 。</span>
|
||
<span>文件中只<a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.rse">保留unexpanded entity references</a> 。</span>
|
||
</dd>
|
||
</dl>
|
||
<p> <span><b>注意:</b>此参数不影响<code>Entity</code>节点。</span> </p>
|
||
</dd>
|
||
<dt>
|
||
<code>"error-handler"</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>必填</em> ]包含一个<code>DOMErrorHandler</code>对象。</span>
|
||
<span>如果在文档中遇到错误时,实现将回调<code>DOMErrorHandler</code>使用此参数注册。</span>
|
||
<span>该实现可以提供默认的<code>DOMErrorHandler</code>对象。</span>
|
||
<span>当调用时, <code>DOMError.relatedData</code>将包含最接近发生错误的节点。</span>
|
||
<span>如果实现无法确定发生错误的节点, <code>DOMError.relatedData</code>将包含<code>Document</code>节点。</span>
|
||
<span>在错误处理程序内对文档的突变将导致执行依赖的行为。</span>
|
||
</dd>
|
||
<dt>
|
||
<code>"infoset"</code>
|
||
</dt>
|
||
<dd>
|
||
<dl>
|
||
<dt>
|
||
<code>true</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>required</em> ]在文档中保存XML信息集[ <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/">XML Information Set</a> ]中定义的信息。这将强制以下参数为<code>false</code> :“validate-if-schema”,“entities”,“datatype-normalization”,“cdata-sections” 。这将强制以下参数为<code>true</code> :“namespace-declaration”,“well-formed”,“element-content-whitespace”,“comments”,“namespaces”。其他参数不会更改,除非在参数。</span>
|
||
<span>请注意,仅当适当设置上述指定的参数时,使用<code>getParameter</code>查询此参数<code>getParameter</code>返回<code>true</code> 。</span>
|
||
</dd>
|
||
<dt>
|
||
<code>false</code>
|
||
</dt>
|
||
<dd>
|
||
<span>设置<code>infoset</code>到<code>false</code>没有任何效果。</span>
|
||
</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt>
|
||
<code>"namespaces"</code>
|
||
</dt>
|
||
<dd>
|
||
<dl>
|
||
<dt>
|
||
<code>true</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>必需</em> ]( <em>默认</em> )按照定义执行命名空间处理。</span>
|
||
</dd>
|
||
<dt>
|
||
<code>false</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>可选</em> ]不要执行命名空间处理。</span>
|
||
</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt>
|
||
<code>"namespace-declarations"</code>
|
||
</dt>
|
||
<dd>
|
||
<span>如果参数“namespaces”设置为<code>false</code> 。</span>
|
||
<dl>
|
||
<dt>
|
||
<code>true</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>必需</em> ]( <em>默认</em> )在文档中包含从模式指定或<em>默认的</em>命名空间声明属性。</span>
|
||
<span>另请参见[ <a href="http://www.w3.org/TR/1999/REC-xml-names-19990114/">XML Namespaces</a> ]和[ <a href="http://www.w3.org/TR/2004/REC-xml-names11-20040204/">XML Namespaces 1.1</a> ]中的“声明命名空间”部分。</span>
|
||
</dd>
|
||
<dt>
|
||
<code>false</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>required</em> ]舍弃所有命名空间声明属性。</span>
|
||
<span>即使该参数设置为<code>false</code> ,命名空间前缀( <code>Node.prefix</code> )仍保留。</span>
|
||
</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt>
|
||
<code>"normalize-characters"</code>
|
||
</dt>
|
||
<dd>
|
||
<dl>
|
||
<dt>
|
||
<code>true</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>可选</em> ] <a href="http://www.w3.org/TR/2004/REC-xml11-20040204/#dt-fullnorm">Fully normalized</a> [ <a href="http://www.w3.org/TR/2004/REC-xml11-20040204/">XML 1.1</a> ]附录B中定义的文件中的<a href="http://www.w3.org/TR/2004/REC-xml11-20040204/">字符</a> 。</span>
|
||
</dd>
|
||
<dt>
|
||
<code>false</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>必需</em> ]( <em>默认</em> )不执行字符规范化。</span>
|
||
</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt>
|
||
<code>"schema-location"</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>可选</em> ]表示包含URI列表的一个<code>DOMString</code>对象,该列表由空格分隔(与第2.3节[ <a href="http://www.w3.org/TR/2004/REC-xml-20040204">XML 1.0</a> ]中定义的nonterminal production S匹配的<a href="http://www.w3.org/TR/2004/REC-xml-20040204#NT-S">字符</a> ),表示应发生验证的模式,即当前模式。</span>
|
||
<span>在此列表中的必须使用指定的类型相匹配引用的架构的<code>schema-type</code> ,否则实现的行为不确定。</span>
|
||
<span>使用此属性指定的模式优先于文档本身指定的模式信息。</span>
|
||
<span>对于名称空间感知模式,如果使用此属性指定的模式和文档实例中指定的架构(即使用<code>schemaLocation</code>属性)在模式文档中(即使用模式<code>import</code>机制)共享相同的<code>targetNamespace</code> ,则由用户指定的模式使用将使用此属性。</span>
|
||
<span>如果使用此属性指定的两个模式共享相同的<code>targetNamespace</code>或没有命名空间,行为是依赖于实现的。</span>
|
||
<span>如果没有提供位置,则此参数为<code>null</code> 。</span>
|
||
<p> <span><b>注意:</b> <code>"schema-location"</code>参数被忽略,除非设置了“模式类型”参数值。</span> <span>强烈建议<code>Document.documentURI</code>会进行设置,以便实现可以成功解析所引用的任何外部实体。</span> </p>
|
||
</dd>
|
||
<dt>
|
||
<code>"schema-type"</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>可选</em> ]表示包含绝对URI的<code>DOMString</code>对象,并表示用于验证文档的模式语言的类型。</span>
|
||
<span>请注意,绝对URI上不进行词法检查。</span>
|
||
<span>如果未设置此参数,则可以根据支持的模式语言和加载时使用的模式语言,由实现提供默认值。</span>
|
||
<span>如果没有提供值,则此参数为<code>null</code> 。</span>
|
||
<p> <span><b>注意:</b>对于XML Schema [ <a href="http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/">XML Schema Part 1</a> ],应用程序必须使用值<code>"http://www.w3.org/2001/XMLSchema"</code> 。</span> <span>对于XML DTD [ <a href="http://www.w3.org/TR/2004/REC-xml-20040204">XML 1.0</a> ],应用程序必须使用值<code>"http://www.w3.org/TR/REC-xml"</code> 。</span> <span>其他模式语言不在W3C的范围之内,因此应该推荐使用绝对URI来使用此方法。</span> </p>
|
||
</dd>
|
||
<dt>
|
||
<code>"split-cdata-sections"</code>
|
||
</dt>
|
||
<dd>
|
||
<dl>
|
||
<dt>
|
||
<code>true</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>必需</em> ]( <em>默认</em> )拆分包含CDATA节终止标记']]>'的CDATA节。</span>
|
||
<span>当CDATA部被分割与发出警告<code>DOMError.type</code>等于<code>"cdata-sections-splitted"</code>和<code>DOMError.relatedData</code>等于第一<code>CDATASection</code>节点按文档顺序从分割得到的。</span>
|
||
</dd>
|
||
<dt>
|
||
<code>false</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>必填</em> ]如果<code>CDATASection</code>包含无法表示的字符,则发出错误信号。</span>
|
||
</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt>
|
||
<code>"validate"</code>
|
||
</dt>
|
||
<dd>
|
||
<dl>
|
||
<dt>
|
||
<code>true</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>可选</em> ]需要根据[ <a href="http://www.w3.org/TR/2004/REC-xml-20040204">XML 1.0</a> ]定义对文档进行标准化的模式(即XML模式,DTD,模式的任何其他类型或模式表示)进行<a href="http://www.w3.org/TR/2004/REC-xml-20040204">验证</a> 。</span>
|
||
<span>如果找到验证错误,或者没有找到模式,则会通知错误处理程序。</span>
|
||
<span>除非参数“datatype-normalization”为<code>true</code> ,否则不会根据所使用的架构公开模式归一化值。</span>
|
||
<span>此参数将重新评估:</span>
|
||
<ul>
|
||
<li> <span>属性节点与<code>Attr.specified</code>等于<code>false</code> ,如在的说明书中指定<code>Attr</code>接口;</span> </li>
|
||
<li> <span>所有<code>Text</code>节点的属性<code>Text.isElementContentWhitespace</code>的值;</span> </li>
|
||
<li> <span>所有<code>Attr</code>节点的属性<code>Attr.isId</code>的值;</span> </li>
|
||
<li> <span>属性<code>Element.schemaTypeInfo</code>和<code>Attr.schemaTypeInfo</code> 。</span> </li>
|
||
</ul>
|
||
<p> <span><b>注意:</b> “validate-if-schema”和“validate”是互斥的,将其中一个设置为<code>true</code>将另一个设置为<code>false</code> 。</span> <span>在验证文档时,应用程序还应考虑将参数“well-formed”设置为<code>true</code> ,该选项是该选项的默认值。</span> </p>
|
||
</dd>
|
||
<dt>
|
||
<code>false</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>必需</em> ]( <em>默认</em> )不要完成模式处理,包括内部子集处理。</span>
|
||
<span>保留默认属性值信息。</span>
|
||
<span>请注意,如果“validate-if-schema”为<code>true</code>则验证可能仍会发生。</span>
|
||
</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt>
|
||
<code>"validate-if-schema"</code>
|
||
</dt>
|
||
<dd>
|
||
<dl>
|
||
<dt>
|
||
<code>true</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>可选</em> ]仅当在模式中找到文档元素的声明(独立于发现的位置,即XML模式,DTD或模式的任何其他类型或表示形式)时才启用验证。</span>
|
||
<span>如果启用验证,此参数与参数“验证”设置为<code>true</code>具有相同的行为。</span>
|
||
<p> <span><b>注意:</b> “validate-if-schema”和“validate”是互斥的,将其中一个设置为<code>true</code>将另一个设置为<code>false</code> 。</span> </p>
|
||
</dd>
|
||
<dt>
|
||
<code>false</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>必需</em> ]( <em>默认</em> )如果文档具有模式(包括内部子集处理),则不应执行模式处理。</span>
|
||
<span>保留默认属性值信息。</span>
|
||
<span>请注意,如果“验证”为<code>true</code> ,则仍必须进行验证。</span>
|
||
</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt>
|
||
<code>"well-formed"</code>
|
||
</dt>
|
||
<dd>
|
||
<dl>
|
||
<dt>
|
||
<code>true</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>需要</em> ]( <em>默认</em> )检查是否所有节点都根据所使用的XML版本中公形成XML <code>Document.xmlVersion</code> :</span>
|
||
<ul>
|
||
<li> <span>检查属性<code>Node.nodeName</code>包含无效字符根据其节点类型,并生成一个<code>DOMError</code>类型的<code>"wf-invalid-character-in-node-name"</code> ,具有<code>DOMError.SEVERITY_ERROR</code>严重程度,如果必要的话;</span> </li>
|
||
<li> <span>检查中的文本内容<code>Attr</code> , <code>Element</code> , <code>Comment</code> , <code>Text</code> , <code>CDATASection</code>的无效字符节点,并生成一个<code>DOMError</code>类型的<code>"wf-invalid-character"</code> ,具有<code>DOMError.SEVERITY_ERROR</code>严重程度,如果必要的话;</span> </li>
|
||
<li> <span>检查里面的数据<code>ProcessingInstruction</code>的无效字符节点,并生成一个<code>DOMError</code>类型的<code>"wf-invalid-character"</code> ,具有<code>DOMError.SEVERITY_ERROR</code>严重程度,如果必要的话;</span> </li>
|
||
</ul>
|
||
</dd>
|
||
<dt>
|
||
<code>false</code>
|
||
</dt>
|
||
<dd>
|
||
<span>[ <em>可选</em> ]不要检查XML的良好状态。</span>
|
||
</dd>
|
||
</dl>
|
||
</dd>
|
||
</dl>
|
||
<p> <span>与实体相关联的系统标识符的分辨率使用<code>Document.documentURI</code>完成。</span> <span>然而,当DOM实现支持[ <a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407">DOM Level 3 Load and Save</a> ]中定义的功能“LS”时,参数“resource-resolver”也可以在<code>Document</code>节点附加的<code>DOMConfiguration</code>对象上使用。</span> <span>如果设置了此参数, <code>Document.normalizeDocument()</code>将调用资源解析器,而不是使用<code>Document.documentURI</code> 。</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>
|
||
<dl>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始:</span>
|
||
</dt>
|
||
<dd>
|
||
DOM 3级
|
||
</dd>
|
||
</dl> </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>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/DOMConfiguration.html#canSetParameter-java.lang.String-java.lang.Object-">canSetParameter</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> value)</code>
|
||
<div class="block">
|
||
检查是否将参数设置为特定值。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/DOMConfiguration.html#getParameter-java.lang.String-">getParameter</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
|
||
<div class="block">
|
||
如果已知,返回参数的值。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<td class="colFirst"><code><a href="../../../org/w3c/dom/DOMStringList.html" title="interface in org.w3c.dom">DOMStringList</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/DOMConfiguration.html#getParameterNames--">getParameterNames</a></span>()</code>
|
||
<div class="block">
|
||
此
|
||
<code>DOMConfiguration</code>对象支持的参数列表,并且应用程序可以
|
||
<code>DOMConfiguration</code>至少设置一个值。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/DOMConfiguration.html#setParameter-java.lang.String-java.lang.Object-">setParameter</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> value)</code>
|
||
<div class="block">
|
||
设置参数的值。
|
||
</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="setParameter-java.lang.String-java.lang.Object-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setParameter</h4> <pre>void setParameter(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
|
||
<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> value)
|
||
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
|
||
<div class="block">
|
||
设置参数的值。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>name</code> - 要设置的参数的名称。
|
||
</dd>
|
||
<dd>
|
||
<span><code>value</code> -新值,或<code>null</code>如果用户希望取消设置该参数。</span>
|
||
<span>虽然value参数的类型定义为<code>DOMUserData</code> ,但对象类型必须与参数定义所定义的类型相匹配。</span>
|
||
<span>例如,如果参数为“error-handler”,则该值必须为<code>DOMErrorHandler</code> 。</span>
|
||
</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:无法识别参数名时引发。</span>
|
||
<br/>
|
||
<span>NOT_SUPPORTED_ERR:在识别参数名称但不能设置请求的值时引发。</span>
|
||
<br/>
|
||
<span>TYPE_MISMATCH_ERR:如果此参数名称的值类型与预期值类型不兼容,则引发。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getParameter-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getParameter</h4> <pre><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> getParameter(<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">
|
||
如果已知,返回参数的值。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>name</code> - 参数的名称。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
与指定参数相关联的当前对象或
|
||
<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_FOUND_ERR:无法识别参数名称时引发。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="canSetParameter-java.lang.String-java.lang.Object-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>canSetParameter</h4> <pre>boolean canSetParameter(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
|
||
<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> value)</pre>
|
||
<div class="block">
|
||
检查是否将参数设置为特定值。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>name</code> - 要检查的参数的名称。
|
||
</dd>
|
||
<dd>
|
||
<span><code>value</code> - 一个对象。</span>
|
||
<span>如果<code>null</code> ,则返回值为<code>true</code> 。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>true</code>如果该参数可以成功设置为指定的值,或<code>false</code>如果该参数不认可或不支持请求的值。</span>
|
||
<span>这不会改变参数本身的当前值。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getParameterNames--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>getParameterNames</h4> <pre><a href="../../../org/w3c/dom/DOMStringList.html" title="interface in org.w3c.dom">DOMStringList</a> getParameterNames()</pre>
|
||
<div class="block">
|
||
The list of the parameters supported by this
|
||
<code>DOMConfiguration</code> object and for which at least one value can be set by the application. Note that this list can also contain parameter names defined outside this specification.
|
||
</div> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |