7827b8b3e4
http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/ git-svn-id: https://svn.apache.org/repos/asf/xml/commons/trunk@226242 13f79535-47bb-0310-9956-ffa450edef68
210 lines
11 KiB
HTML
210 lines
11 KiB
HTML
<!DOCTYPE html PUBLIC
|
|
"-//W3C//DTD HTML 4.01 Transitional//EN"
|
|
"http://www.w3.org/TR/html4/loose.dtd">
|
|
<!--
|
|
Generated: Wed Apr 07 13:11:21 EDT 2004 jfouffa.w3.org
|
|
-->
|
|
<html lang='en-US'>
|
|
<head>
|
|
<title>Configuration Settings</title>
|
|
<link rel='stylesheet' type='text/css' href='./spec.css'>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
<link rel='stylesheet' type='text/css' href='W3C-REC.css'>
|
|
<link rel='next' href='accessing-code-point-boundaries.html'>
|
|
<link rel='contents' href='Overview.html#contents'>
|
|
<link rel='copyright' href='copyright-notice.html'>
|
|
<link rel='glossary' href='glossary.html'>
|
|
<link rel='Start' href='Overview.html'>
|
|
<link rel='index' href='def-index.html'>
|
|
<link rel='author' href='mailto:www-dom@w3.org'>
|
|
<link rel='help' href='http://www.w3.org/DOM/'>
|
|
<link rel='prev' href='infoset-mapping.html'>
|
|
</head>
|
|
<body>
|
|
<div class='navbar' style='text-align: center'>
|
|
<map id='navbar-top' name='navbar-top' title='Navigation Bar'><p>
|
|
[<a title='Infoset Mapping' accesskey='p' href='infoset-mapping.html'><strong><u>p</u></strong>revious</a>]
|
|
[<a title='Accessing code point boundaries' accesskey='n' href='accessing-code-point-boundaries.html'><strong><u>n</u></strong>ext</a>] [<a title='Table of Contents' accesskey='c' href='Overview.html#contents'><strong><u>c</u></strong>ontents</a>] [<a title='Index'
|
|
accesskey='i' href='def-index.html'><strong><u>i</u></strong>ndex</a>]</p>
|
|
<hr title='Navigation area separator'>
|
|
</map></div>
|
|
<div class='noprint' style='text-align: right'>
|
|
<p style='font-family: monospace;font-size:small'>07 April 2004</p>
|
|
</div>
|
|
|
|
<div class='div1'><a name='Parameters'></a>
|
|
<h1 id='Parameters-h1' class='adiv1'>Appendix D: Configuration Settings</h1>
|
|
<dl>
|
|
<dt><i>Editor</i>:
|
|
</dt><dd>Elena Litani, IBM</dd>
|
|
</dl>
|
|
|
|
<div class='div2'><a name='ConfigTable'></a>
|
|
<h2 id='ConfigTable-h2' class='adiv2'>D.1 Configuration Scenarios</h2>
|
|
<p>
|
|
Using the <a href='core.html#DOMConfiguration'><code>DOMConfiguration</code></a> users can change behavior
|
|
of the <code>DOMParser</code>, <code>DOMSerializer</code> and
|
|
<a href='core.html#Document3-normalizeDocument'><code>Document.normalizeDocument()</code></a>. If a DOM
|
|
implementation supports XML Schemas and DTD validation, the table
|
|
below defines behavior of such implementation following various
|
|
parameter settings on the <a class='noxref' href='core.html#DOMConfiguration'><code>DOMConfiguration</code></a>. Errors
|
|
are effectively reported only if a <a href='core.html#ERROR-Interfaces-DOMErrorHandler'><code>DOMErrorHandler</code></a>
|
|
object is attached to the "<a href='core.html#parameter-error-handler'>error-handler</a>" parameter.
|
|
</p><table border='1' summary='Layout table: the first cell contains the value of schema-type parameter, the second contains the value of validate parameter, the third contains the value of the validate-if-schema parameter, the 4th contains the actual document schemas, the 5th contains the output of such configuration, the 6th list addition parameters that can be effected.' cellpadding='3'
|
|
>
|
|
<tr>
|
|
<th rowspan='1' colspan='1'>
|
|
"<a href='core.html#parameter-schema-type'>schema-type</a>"</th><th rowspan='1' colspan='1'>
|
|
"<a href='core.html#parameter-validate'>validate</a>"</th><th rowspan='1' colspan='1'>
|
|
"<a href='core.html#parameter-validate-if-schema'>validate-if-schema</a>"</th><th rowspan='1' colspan='1'>
|
|
Instance schemas, i.e. the current schema</th><th rowspan='1' colspan='1'>
|
|
Outcome</th><th rowspan='1' colspan='1'>
|
|
Other parameters</th></tr>
|
|
<tr>
|
|
<td valign='top' rowspan='2' colspan='1'>
|
|
<code>null</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>true</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>false</code></td><td valign='top' rowspan='2' colspan='1'>
|
|
DTD and XML Schema</td><td valign='top' rowspan='2' colspan='1'>
|
|
Implementation dependent</td><td valign='top' rowspan='2' colspan='1'>
|
|
|
|
The outcome of setting the "<a href='core.html#parameter-datatype-normalization'>datatype-normalization</a>",
|
|
"<a href='core.html#parameter-element-content-whitespace'>element-content-whitespace</a>"
|
|
or "<a href='core.html#parameter-namespaces'>namespaces</a>" parameters
|
|
to <code>true</code> or <code>false</code> is implementation
|
|
dependent.
|
|
</td></tr>
|
|
<tr>
|
|
<td valign='top' rowspan='1' colspan='1'>
|
|
<code>false</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>true</code></td></tr>
|
|
<tr>
|
|
<td valign='top' rowspan='2' colspan='1'>
|
|
<code>null</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>true</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>false</code></td><td valign='top' rowspan='2' colspan='1'>
|
|
none</td><td valign='top' rowspan='1' colspan='1'>
|
|
Report an error</td><td valign='top' rowspan='2' colspan='1'>
|
|
|
|
Setting the "<a href='core.html#parameter-datatype-normalization'>datatype-normalization</a>"
|
|
to <code>true</code> or <code>false</code> has no effect on
|
|
the DOM.
|
|
</td></tr>
|
|
<tr>
|
|
<td valign='top' rowspan='1' colspan='1'>
|
|
<code>false</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>true</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
No error is reported</td></tr>
|
|
<tr>
|
|
<td valign='top' rowspan='2' colspan='1'>
|
|
<code>null</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>true</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>false</code></td><td valign='top' rowspan='2' colspan='1'>
|
|
DTD</td><td valign='top' rowspan='2' colspan='1'>
|
|
Validate against DTD</td><td valign='top' rowspan='2' colspan='1'>
|
|
|
|
Setting the "<a href='core.html#parameter-datatype-normalization'>datatype-normalization</a>"
|
|
to <code>true</code> or <code>false</code> has no effect on
|
|
the DOM. </td></tr>
|
|
<tr>
|
|
<td valign='top' rowspan='1' colspan='1'>
|
|
<code>false</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>true</code></td></tr>
|
|
<tr>
|
|
<td valign='top' rowspan='2' colspan='1'>
|
|
<code>null</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>true</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>false</code></td><td valign='top' rowspan='2' colspan='1'>
|
|
XML Schema</td><td valign='top' rowspan='2' colspan='1'>
|
|
|
|
Validate against XML Schema
|
|
</td><td valign='top' rowspan='2' colspan='1'>
|
|
|
|
The outcome of setting the "<a href='core.html#parameter-namespaces'>namespaces</a>" to
|
|
<code>false</code> is implementation dependent (likely to be
|
|
an error). Setting the "<a href='core.html#parameter-element-content-whitespace'>element-content-whitespace</a>"
|
|
to <code>false</code> does not have any effect on the DOM.
|
|
</td></tr>
|
|
<tr>
|
|
<td valign='top' rowspan='1' colspan='1'>
|
|
<code>false</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>true</code></td></tr>
|
|
<tr>
|
|
<td valign='top' rowspan='2' colspan='1'>
|
|
<code>"http://www.w3.org/TR/REC-xml"</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>true</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>false</code></td><td valign='top' rowspan='2' colspan='1'>
|
|
DTD or XML Schema or both</td><td valign='top' rowspan='1' colspan='1'>
|
|
|
|
If DTD is found, validate against DTD. Otherwise, report an
|
|
error.
|
|
</td><td valign='top' rowspan='2' colspan='1'>
|
|
|
|
Setting the "<a href='core.html#parameter-datatype-normalization'>datatype-normalization</a>"
|
|
to <code>true</code> or <code>false</code> has no effect on
|
|
the DOM.
|
|
</td></tr>
|
|
<tr>
|
|
<td valign='top' rowspan='1' colspan='1'>
|
|
<code>false</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>true</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
If DTD is found, validate against DTD.</td></tr>
|
|
<tr>
|
|
<td valign='top' rowspan='2' colspan='1'>
|
|
<code>"http://www.w3.org/2001/XMLSchema"</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>true</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>false</code></td><td valign='top' rowspan='2' colspan='1'>
|
|
DTD or XML Schema or both</td><td valign='top' rowspan='1' colspan='1'>
|
|
|
|
If XML Schema is found, validate against the schema.
|
|
Otherwise, report an error.
|
|
</td><td valign='top' rowspan='2' colspan='1'>
|
|
|
|
Setting the "<a href='core.html#parameter-datatype-normalization'>datatype-normalization</a>"
|
|
to <code>true</code> exposes XML Schema <a class='normative' href='http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/#key-nv'>normalized values</a> in the
|
|
DOM. The outcome of setting the "<a href='core.html#parameter-namespaces'>namespaces</a>" to
|
|
<code>false</code> is implementation dependent (likely to be
|
|
an error).
|
|
</td></tr>
|
|
<tr>
|
|
<td valign='top' rowspan='1' colspan='1'>
|
|
<code>false</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>true</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
|
|
If XML Schema is found, validate against the schema.
|
|
</td></tr>
|
|
<tr>
|
|
<td valign='top' rowspan='1' colspan='1'>
|
|
|
|
<code>"http://www.w3.org/2001/XMLSchema"</code> or
|
|
<code>"http://www.w3.org/TR/REC-xml"</code>
|
|
</td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>false</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
<code>false</code></td><td valign='top' rowspan='1' colspan='1'>
|
|
DTD or XML Schema or both</td><td valign='top' rowspan='1' colspan='1'>
|
|
|
|
If XML Schema is found, it is ignored. DOM implementations
|
|
<a class='normative' href='http://www.w3.org/TR/2004/REC-xml-20040204#proc-types'>may</a> use information
|
|
available in the DTD to perform <a class='normative' href='http://www.w3.org/TR/2004/REC-xml-20040204#intern-replacement'>entity
|
|
resolution</a>.
|
|
</td><td valign='top' rowspan='1' colspan='1'>
|
|
|
|
Setting the "<a href='core.html#parameter-datatype-normalization'>datatype-normalization</a>"
|
|
to <code>true</code> of <code>false</code> has no effect on
|
|
the DOM.
|
|
</td></tr>
|
|
</table>
|
|
<p><b>Note:</b>
|
|
If an error has to be reported, as specified in the "Outcome"
|
|
column above, the <a href='core.html#ERROR-DOMError-type'><code>DOMError.type</code></a> is
|
|
<code>"no-schema-available"</code>.
|
|
</p>
|
|
</div> <!-- div2 ConfigTable --></div> <!-- div1 Parameters --><div class='navbar' style='text-align: center'>
|
|
<map id='navbar-bottom' name='navbar-bottom' title='Navigation Bar'><hr title='Navigation area separator'><p>
|
|
[<a title='Infoset Mapping' href='infoset-mapping.html'><strong><u>p</u></strong>revious</a>]
|
|
[<a title='Accessing code point boundaries' href='accessing-code-point-boundaries.html'><strong><u>n</u></strong>ext</a>] [<a title='Table of Contents' href='Overview.html#contents'><strong><u>c</u></strong>ontents</a>] [<a title='Index'
|
|
href='def-index.html'><strong><u>i</u></strong>ndex</a>]</p>
|
|
</map></div>
|
|
</body>
|
|
</html>
|