88 |
over which <abbr>DOM</abbr> applications are able to access to the |
over which <abbr>DOM</abbr> applications are able to access to the |
89 |
definitions of the document type.</p> |
definitions of the document type.</p> |
90 |
|
|
91 |
<p>Interfaces defined in this specification are partially modeled from |
<p>Interfaces defined in this document are partially modeled and inspired by |
92 |
early drafts of <abbr>DOM</abbr> level 1 <span class=ed>@@ ref</span>, |
early drafts of <abbr>DOM</abbr> Level 1 |
93 |
<abbr>DOM</abbr> Abstract Schema level 3 <span class=ed>@@ ref</span>, and |
<cite class="bibref informative">[<a href="#ref-DOM1WD">DOM1WD</a>]</cite>, |
94 |
<abbr>XML</abbr> Schema <abbr>API</abbr>, but are not compatible with |
<abbr>DOM</abbr> Level 3 Abstract Schemas <abbr>W3C</abbr> Note |
95 |
any of them as a whole.</p> |
<cite class="bibref informative">[<a href="#ref-DOM3AS">DOM3AS</a>]</cite>, |
96 |
|
and <abbr>XML</abbr> Schema <abbr>API</abbr> specification |
97 |
|
<cite class="bibref informative">[<a href="#ref-XSAPI">XSAPI</a>]</cite>, but |
98 |
|
they are not compatible with any of them as a whole.</p> |
99 |
</div> |
</div> |
100 |
|
|
101 |
<div class="section" id=conformance> |
<div class="section" id=conformance> |
123 |
|
|
124 |
<p>Sometimes an exception is phrased as being required to be raised. As |
<p>Sometimes an exception is phrased as being required to be raised. As |
125 |
specified in the <abbr>DOM</abbr> Core specification |
specified in the <abbr>DOM</abbr> Core specification |
126 |
<span class=ed>[DOM3]</span>, |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>, |
127 |
when the value of the <code>strictErrorChecking</code> attribute of the |
when the value of the <code>strictErrorChecking</code> attribute of the |
128 |
<a href="#Document"><code>Document</code></a> node is <code>false</code>, |
<a href="#Document"><code>Document</code></a> node is <code>false</code>, |
129 |
then the exception is not have to be raised.</p> |
then the exception is not have to be raised.</p> |
140 |
<p>The construction <q>raise a <code><var>Bar</var></code></q>, where |
<p>The construction <q>raise a <code><var>Bar</var></code></q>, where |
141 |
<code><var>Bar</var></code> is an exception code, is used instead of the more |
<code><var>Bar</var></code> is an exception code, is used instead of the more |
142 |
accurate <q>raise an exception implementing the interface |
accurate <q>raise an exception implementing the interface |
143 |
<code>DOMException</code> <span class=ed>[DOM3]</span> with its |
<code>DOMException</code> |
144 |
<code>code</code> attribute set to <code><var>Bar</var></code></q>.</p> |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite> |
145 |
|
with its <code>code</code> attribute set to |
146 |
|
<code><var>Bar</var></code></q>.</p> |
147 |
|
|
148 |
|
<p>The terms |
149 |
|
<em id=live><a href="http://www.whatwg.org/specs/web-apps/current-work/#live">live</a></em> |
150 |
|
and <em id=setting>setting</em> and <em id=getting>getting</em> of an attribute |
151 |
|
is defined in the HTML5 specification |
152 |
|
<cite class="bibref normative">[<a href="#ref-HTML5">HTML5</a>]</cite>.</p> |
153 |
|
|
154 |
<p>The term |
<p>The term |
155 |
<q id=live><a href="http://www.whatwg.org/specs/web-apps/current-work/#live">live</a></q> |
<em id=read-only><a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/glossary.html#dt-readonly-node">read$B!>(Bonly (node)</a></em> |
156 |
is defined in the HTML5 specification <span class=ed>[HTML5]</span>.</p> |
is defined in the <abbr>DOM</abbr> Level 3 Core specification |
157 |
|
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p> |
158 |
|
|
159 |
<p class=ed>@@ ref to DOM Binding Spec</p> |
<p class=ed>@@ ref to DOM Binding Spec</p> |
160 |
</div> |
</div> |
172 |
by this and other documents. Unless otherwise noted, requirements in this |
by this and other documents. Unless otherwise noted, requirements in this |
173 |
document are applied to <abbr>DOM</abbr> implementations. To implement |
document are applied to <abbr>DOM</abbr> implementations. To implement |
174 |
all the features in this document, the implementation have to implement |
all the features in this document, the implementation have to implement |
175 |
some version of <abbr>DOM</abbr> Core (e.g. <abbr>DOM</abbr> level 3 |
some version of <abbr>DOM</abbr> Core (e.g. <abbr>DOM</abbr> Level 3 Core |
176 |
<span class=ed>[DOM3]</span>) with one or more language binding (e.g. |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>) |
177 |
ECMAScript or Java binding <span class=ed>[BINDINGS]</span> or |
with one or more language binding (e.g. ECMAScript or Java binding <span class=ed>[BINDINGS]</span> or |
178 |
Perl binding <span class=ed>[PERLBINDING]</span>).</dd> |
Perl binding <span class=ed>[PERLBINDING]</span>).</dd> |
179 |
<dt id=category-xml-parser><abbr>XML</abbr> Parser (<abbr>XML</abbr> document |
<dt id=category-xml-parser><abbr>XML</abbr> Parser (<abbr>XML</abbr> document |
180 |
to <abbr>DOM</abbr> tree converter)</dt> |
to <abbr>DOM</abbr> tree converter)</dt> |
181 |
<dd>A software component that converts |
<dd>A software component that converts |
182 |
<abbr>XML</abbr> 1.0 or 1.1 document (or fragment thereof) into a |
<abbr>XML</abbr> 1.0 or 1.1 document |
183 |
|
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
184 |
|
<a href="#ref-XML11">XML11</a>]</cite> (or fragment thereof) into a |
185 |
<abbr>DOM</abbr> tree (or fragment thereof) in the context of this |
<abbr>DOM</abbr> tree (or fragment thereof) in the context of this |
186 |
document. Note that this document does not define any particular way to |
document. Note that this document does not define any particular way to |
187 |
parse an <abbr>XML</abbr> document or to construct an <abbr>DOM</abbr> |
parse an <abbr>XML</abbr> document or to construct an <abbr>DOM</abbr> |
196 |
<dt id=category-infoset-dom><abbr>XML</abbr> Information Set to |
<dt id=category-infoset-dom><abbr>XML</abbr> Information Set to |
197 |
<abbr>DOM</abbr> Tree Converter</dt> |
<abbr>DOM</abbr> Tree Converter</dt> |
198 |
<dd>A software component that converts an <abbr>XML</abbr> information set |
<dd>A software component that converts an <abbr>XML</abbr> information set |
199 |
|
<cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite> |
200 |
into a <abbr>DOM</abbr> tree. Note that this documetn does not define |
into a <abbr>DOM</abbr> tree. Note that this documetn does not define |
201 |
any particular way for the convertion, but it defines constraints for |
any particular way for the convertion, but it defines constraints for |
202 |
such processing.</dd> |
such processing.</dd> |
224 |
<a href="#Document"><code>Document</code></a>, |
<a href="#Document"><code>Document</code></a>, |
225 |
<a href="#DocumentType"><code>DocumentType</code></a>, |
<a href="#DocumentType"><code>DocumentType</code></a>, |
226 |
<a href="#Entity"><code>Entity</code></a>, and |
<a href="#Entity"><code>Entity</code></a>, and |
227 |
<a href="#Notation"><code>Notation</code></a>.</p> |
<a href="#Notation"><code>Notation</code></a> |
228 |
|
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p> |
229 |
|
|
230 |
<div class=section id=features> |
<div class=section id=features> |
231 |
<h3>Feature String</h3> |
<h3>Feature String</h3> |
233 |
<p>In a <abbr>DOM</abbr> implementation that supports the version 3.0 of |
<p>In a <abbr>DOM</abbr> implementation that supports the version 3.0 of |
234 |
the <abbr>DOM</abbr> Document Type Definition module, the |
the <abbr>DOM</abbr> Document Type Definition module, the |
235 |
<code>hasFeature</code> method of a <code>DOMImplementation</code> object |
<code>hasFeature</code> method of a <code>DOMImplementation</code> object |
236 |
|
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite> |
237 |
<em class=rfc2119>MUST</em> return <code>true</code> when the parameters are |
<em class=rfc2119>MUST</em> return <code>true</code> when the parameters are |
238 |
set to |
set to |
239 |
<dfn id=feature-XDoctype><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></dfn> |
<dfn id=feature-XDoctype><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></dfn> |
315 |
and at least one of them has the support for the feature |
and at least one of them has the support for the feature |
316 |
<a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>:</p> |
<a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>:</p> |
317 |
<ul> |
<ul> |
318 |
<li>they are equal according to <abbr>DOM</abbr> level 3 definition |
<li>they are equal according to <abbr>DOM</abbr> Level 3 Core definition |
319 |
<span class=ed>@@ ref</span>, and |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>, |
320 |
|
and |
321 |
<li>either: |
<li>either: |
322 |
<ul><!-- |
<ul><!-- |
323 |
<li>both of them does not support the feature |
<li>both of them does not support the feature |
417 |
On getting, the attributes <em class=rfc2119>MUST</em> return |
On getting, the attributes <em class=rfc2119>MUST</em> return |
418 |
<code>null</code>.</p> |
<code>null</code>.</p> |
419 |
|
|
420 |
<div class="note memo"> |
<div class="note memo"> |
421 |
<p>Thus, on setting the attributes does nothing |
<p>Thus, on setting the attributes does nothing |
422 |
<span class=ed>[DOM3]</span>.</p> |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p> |
423 |
</div> |
</div> |
|
|
|
|
<p>On setting, the <a href="#textContent"><code>textContent</code></a> |
|
|
attribute <em class=rfc2119>MUST NOT</em> raise a |
|
|
<code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>. |
|
|
<span class=ed>@@ I forgot why this requirement is necessary.</span></p> |
|
424 |
|
|
425 |
<p>If the node is an |
<p>If the node is an |
426 |
<a href="#AttributeDefinition"><code>AttributeDefinition</code></a>: |
<a href="#AttributeDefinition"><code>AttributeDefinition</code></a>: |
427 |
The attribute <em class=rfc2119>MUST</em> behave as if the node |
The attribute <em class=rfc2119>MUST</em> behave as if the node |
428 |
were <code>Attr</code> <span class=ed>[DOM3]</span>.</p></dd> |
were <code>Attr</code> |
429 |
|
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p></dd> |
430 |
<dt><code id=normalize>normalize</code></dt> |
<dt><code id=normalize>normalize</code></dt> |
431 |
<dd><p>When a <a href="#DocumentType"><code>DocumentType</code></a> is |
<dd><p>When a <a href="#DocumentType"><code>DocumentType</code></a> is |
432 |
normalized, any nodes in the <code>NamedNodeMap</code> object in the |
normalized, any nodes in the <code>NamedNodeMap</code> object in the |
488 |
and <a href="#feature-XDoctype-3.0"><code>3.0</code></a> respectively (if the |
and <a href="#feature-XDoctype-3.0"><code>3.0</code></a> respectively (if the |
489 |
<a href="#Document"><code>Document</code></a> node supports the |
<a href="#Document"><code>Document</code></a> node supports the |
490 |
feature <code>Core</code> version <code>3.0</code> |
feature <code>Core</code> version <code>3.0</code> |
491 |
<span class=ed>[DOM3]</span>).</p> |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p> |
492 |
|
|
493 |
<p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface |
<p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface |
494 |
<em class=rfc2119>MUST</em> be implemented as following:</p> |
<em class=rfc2119>MUST</em> be implemented as following:</p> |
516 |
<dd> |
<dd> |
517 |
<p>This method creates a <code>DocumentType</code> node with the specified |
<p>This method creates a <code>DocumentType</code> node with the specified |
518 |
name, belonging to the document.</p> |
name, belonging to the document.</p> |
519 |
<p>The <dfn id=createDocumentTypeDefinition-name class=dom-param><var>name</var></dfn> |
<p>The |
520 |
|
<dfn id=createDocumentTypeDefinition-name class=dom-param><var>name</var></dfn> |
521 |
parameter is the name of the document type.</p> |
parameter is the name of the document type.</p> |
522 |
|
|
523 |
<p>When invoked, the method <em class=rfc2119>MUST</em> create and |
<p>When invoked, the method <em class=rfc2119>MUST</em> create and |
524 |
return a <code>DocumentType</code> node with the following attributes:</p> |
return a <a href="#DocumentType"><code>DocumentType</code></a> node with |
525 |
|
the following attributes:</p> |
526 |
<dl> |
<dl> |
527 |
<dt><code>attributes</code>, <code>parentNode</code></dt> |
<dt><code>attributes</code>, <code>parentNode</code></dt> |
528 |
<dd><code>null</code>.</dd> |
<dd><code>null</code>.</dd> |
529 |
<dt><code>elementTypes</code>, <code>generalEntities</code>, and |
<dt><a href="#elementTypes"><code>elementTypes</code></a>, |
530 |
<code>notations</code></dt> |
<a href="#entities"><code>entities</code></a>, and |
531 |
<dd>Empty <code>NamedNodeMap</code> objects.</dd> |
<a href="#notations"><code>notations</code></a></dt> |
532 |
<dt><code>entities</code></dt> |
<dd>Empty <code>NamedNodeMap</code> objects respectively.</dd> |
|
<dd>The same value as the <code>generalEntities</code> attribute.</dd> |
|
533 |
<dt><code>childNodes</code></dt> |
<dt><code>childNodes</code></dt> |
534 |
<dd>An empty <code>NodeList</code> object.</dd> |
<dd>An empty <code>NodeList</code> object.</dd> |
535 |
<dt><code>internalSubset</code>, <code>publicId</code>, and |
<dt><a href="#internalSubset"><code>internalSubset</code></a>, |
536 |
<code>systemId</code></dt> |
<a href="#publicId"><code>publicId</code></a>, and |
537 |
|
<a href="#systemId"><code>systemId</code></a></dt> |
538 |
<dd>Empty strings.</dd> |
<dd>Empty strings.</dd> |
539 |
<dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt> |
<dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt> |
540 |
<dd><code>false</code>.</dd> |
<dd><code>false</code>.</dd> |
541 |
<dt><code>nodeName</code></dt> |
<dt><code>nodeName</code></dt> |
542 |
<dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd> |
<dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd> |
543 |
<dt><code>ownerDocument</code></dt> |
<dt><code>ownerDocument</code></dt> |
544 |
<dd>The <code>Document</code> over which the method is invoked.</dd> |
<dd>The <a href="#Document"><code>Document</code></a> node over which the |
545 |
|
method is invoked.</dd> |
546 |
</dl> |
</dl> |
547 |
<p>In addition, the method <em class=rfc2119>MUST</em> be marked as |
<p>In addition, the method <em class=rfc2119>MUST</em> be marked as |
548 |
containing five general entity declarations: <code>amp</code>, |
containing five general entity declarations: <code>amp</code>, |
565 |
<dl> |
<dl> |
566 |
<dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt> |
<dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt> |
567 |
<dd>An empty <code>NamedNodeMap</code> object.</dd> |
<dd>An empty <code>NamedNodeMap</code> object.</dd> |
568 |
<dt><code>attributes</code>, <code>parentNode</code></dt> |
<dt><a href="#attributes"><code>attributes</code></a>, |
569 |
|
<code>parentNode</code></dt> |
570 |
<dd><code>null</code>.</dd> |
<dd><code>null</code>.</dd> |
571 |
<dt><code>childNodes</code></dt> |
<dt><code>childNodes</code></dt> |
572 |
<dd>An empty <code>NodeList</code> object.</dd> |
<dd>An empty <code>NodeList</code> object.</dd> |
573 |
<dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt> |
<dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt> |
574 |
<dd><code>false</code>.</dd> |
<dd><code>false</code>.</dd> |
575 |
<dt><code>nodeName</code></dt> |
<dt><a href="#nodeName"><code>nodeName</code></a></dt> |
576 |
<dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd> |
<dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd> |
577 |
<dt><code>ownerDocument</code></dt> |
<dt><code>ownerDocument</code></dt> |
578 |
<dd>The <code>Document</code> node over which the method is invoked.</dd> |
<dd>The <code>Document</code> node over which the method is invoked.</dd> |
595 |
<a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
<a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
596 |
node with the following attributes:</p> |
node with the following attributes:</p> |
597 |
<dl> |
<dl> |
598 |
<dt><code>allowedTokens</code></dt> |
<dt><a href="#allowedTokens"><code>allowedTokens</code></a></dt> |
599 |
<dd>An empty <code>DOMStringList</code> object.</dd> |
<dd>An empty <code>DOMStringList</code> object.</dd> |
600 |
<dt><code>attributes</code>, |
<dt><a href="#attributes"><code>attributes</code></a>, |
601 |
<a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a>, |
<a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a>, |
602 |
and <code>parentNode</code></dt> |
and <code>parentNode</code></dt> |
603 |
<dd><code>null</code>.</dd> |
<dd><code>null</code>.</dd> |
604 |
<dt><code>childNodes</code></dt> |
<dt><code>childNodes</code></dt> |
605 |
<dd>An empty <code>NodeList</code> object.</dd> |
<dd>An empty <code>NodeList</code> object.</dd> |
606 |
<dt><code>declaredType</code></dt> |
<dt><a href="#declaredType"><code>declaredType</code></a></dt> |
607 |
<dd><a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</dd> |
<dd><a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</dd> |
608 |
<dt><code>defaultType</code></dt> |
<dt><a href="#defaultType"><code>defaultType</code></a></dt> |
609 |
<dd><a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</dd> |
<dd><a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</dd> |
610 |
<dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt> |
<dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt> |
611 |
<dd><code>false</code>.</dd> |
<dd><code>false</code>.</dd> |
612 |
<dt><code>nodeName</code></dt> |
<dt><a href="#nodeName"><code>nodeName</code></a></dt> |
613 |
<dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd> |
<dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd> |
614 |
<dt><code>ownerDocument</code></dt> |
<dt><code>ownerDocument</code></dt> |
615 |
<dd>The <code>Document</code> node over which the method is invoked.</dd> |
<dd>The <code>Document</code> node over which the method is invoked.</dd> |
616 |
<dt class=ed>@@ Ensure all attributes are defined</dt> |
<dt class=ed>@@ Ensure all attributes are defined</dt> |
617 |
</dl> |
</dl> |
618 |
|
|
619 |
|
<!-- This requirement, if not droped, should be part of xml-id spec. |
620 |
<div class=ed> |
<div class=ed> |
621 |
<p>@@ Should we keep these statements?: |
<p>@@ Should we keep these statements?: |
622 |
However, if the <cfg::cfg|xml-id> configuration |
However, if the <cfg::cfg|xml-id> configuration |
624 |
is <code>xml:id</code>, then the [CODE(DOMa)@en[[[declaredType]]]] |
is <code>xml:id</code>, then the [CODE(DOMa)@en[[[declaredType]]]] |
625 |
attribute is set to <code>ID_ATTR</code>. |
attribute is set to <code>ID_ATTR</code>. |
626 |
[CODE(DOMa)@en[[[defaultType]]]]?</p> |
[CODE(DOMa)@en[[[defaultType]]]]?</p> |
627 |
</div> |
</div>--> |
628 |
</dd> |
</dd> |
629 |
<dt><dfn id=createGeneralEntity class=dom-method><code>createGeneralEntity</code></dfn>, |
<dt><dfn id=createGeneralEntity class=dom-method><code>createGeneralEntity</code></dfn>, |
630 |
method</dt> |
method</dt> |
639 |
an <a href="#Entity"><code>Entity</code></a> node with the following |
an <a href="#Entity"><code>Entity</code></a> node with the following |
640 |
attributes:</p> |
attributes:</p> |
641 |
<dl> |
<dl> |
642 |
<dt><code>attributes</code>, <code>notationName</code>, |
<dt><code>attributes</code>, |
643 |
|
<a href="#notationName"><code>notationName</code></a>, |
644 |
<a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>, |
<a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>, |
645 |
and <code>parentNode</code></dt> |
and <code>parentNode</code></dt> |
646 |
<dd><code>null</code>.</dd> |
<dd><code>null</code>.</dd> |
669 |
</dd> |
</dd> |
670 |
<dt><code>ownerDocument</code></dt> |
<dt><code>ownerDocument</code></dt> |
671 |
<dd>The <code>Document</code> node over which the method is invoked.</dd> |
<dd>The <code>Document</code> node over which the method is invoked.</dd> |
672 |
<dt><code>publicId</code>, and <code>systemId</code></dt> |
<dt><a href="#publicId"><code>publicId</code></a> and |
673 |
|
<a href="#systemId"><code>systemId</code></a></dt> |
674 |
<dd><code>null</code>.</dd> |
<dd><code>null</code>.</dd> |
675 |
<dd class=ed>@@ publicId and systemId should be empty string?</dd> |
<dd class=ed>@@ publicId and systemId should be empty string?</dd> |
676 |
<dt class=ed>@@ Ensure all attributes are defined</dd> |
<dt class=ed>@@ Ensure all attributes are defined</dd> |
701 |
<dd><a href="#createNotation-name"><var>name</var></a>.</dd> |
<dd><a href="#createNotation-name"><var>name</var></a>.</dd> |
702 |
<dt><code>ownerDocument</code></dt> |
<dt><code>ownerDocument</code></dt> |
703 |
<dd>The <code>Document</code> node over which the method is invoked.</dd> |
<dd>The <code>Document</code> node over which the method is invoked.</dd> |
704 |
<dt><code>publicId</code> and <code>systemId</code></dt> |
<dt><a href="#publicId"><code>publicId</code></a> and |
705 |
|
<a href="#systemId"><code>systemId</code></a></dt> |
706 |
<dd><code>null</code>.</dd> |
<dd><code>null</code>.</dd> |
707 |
<dd class=ed>@@ publicId and systemId should be empty string?</dd> |
<dd class=ed>@@ publicId and systemId should be empty string?</dd> |
708 |
<dt class=ed>@@ Ensure all attributes are defined</dt> |
<dt class=ed>@@ Ensure all attributes are defined</dt> |
711 |
</dl> |
</dl> |
712 |
|
|
713 |
<p>These methods <em class=rfc2119>MUST</em> raise an |
<p>These methods <em class=rfc2119>MUST</em> raise an |
714 |
<code>INVALID_CHARACTER_ERR</code> exception <span class=ed>@@ ref</span> |
<code>INVALID_CHARACTER_ERR</code> if <var>name</var> is <em>not</em> a legal |
715 |
if <var>name</var> is <em>not</em> a legal <code>Name</code> according to |
<code>Name</code> |
716 |
the <abbr>XML</abbr> version in use, as specified in the |
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
717 |
<code>xmlVersion</code> attribute of the <code>Document</code> node.</p> |
<a href="#ref-XML11">XML11</a>]</cite> according to the <abbr>XML</abbr> |
718 |
|
version specified in the <code>xmlVersion</code> attribute of the |
719 |
|
<a href="#Document"><code>Document</code></a> node.</p> |
720 |
|
|
721 |
<div class="note memo"> |
<div class="note memo"> |
722 |
<p>Non$B!>(B<abbr>XML</abbr> case is intentionally left unspecified for now, |
<p>Non$B!>(B<abbr>XML</abbr> case is intentionally left unspecified for now, |
723 |
since <abbr>DOM3</abbr> specification <span class=ed>@@ ref</span> does not |
since <abbr>DOM</abbr> Level 3 Core specification |
724 |
define it for <code>Document</code> methods.</p> |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite> |
725 |
|
does not define it for <a href="#Document"><code>Document</code></a> |
726 |
|
methods.</p> |
727 |
|
|
728 |
<p><var>name</var> does not have to be a namespace qualified name.</p> |
<p><var>name</var> does not have to be a namespace qualified name.</p> |
729 |
</div> |
</div> |
748 |
object <em class=rfc2119>MUST</em> contains the |
object <em class=rfc2119>MUST</em> contains the |
749 |
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> |
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> |
750 |
nodes representing the processing instructions in the document type |
nodes representing the processing instructions in the document type |
751 |
definition of the document processed <span class=ed>@@ ref</span> by |
definition of the document processed |
752 |
the <abbr>XML</abbr> processor. If the |
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
753 |
<a href="#DocumentType"><code>DocumentType</code></a> node is marked |
<a href="#ref-XML11">XML11</a>]</cite> by the <abbr>XML</abbr> processor. If |
754 |
as read$B!>(Bonly, then all the child nodes <em class=rfc2119>MUST</em> |
the <a href="#DocumentType"><code>DocumentType</code></a> node is marked as |
755 |
also be marked as read$B!>(Bonly.</p> |
<a href="#read-only">read$B!>(Bonly</a>, then all the child nodes |
756 |
|
<em class=rfc2119>MUST</em> also be marked as |
757 |
|
<a href="#read-only">read$B!>(Bonly</a>.</p> |
758 |
|
|
759 |
<p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is created |
<p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is created |
760 |
from a document type declaration information item <span class=ed>@@ ref</span>, |
from a |
761 |
|
<a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.doctype">document |
762 |
|
type declaration information item</a> |
763 |
|
<cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>, |
764 |
the <code>NodeList</code> object in the <code>childNodes</code> attribute |
the <code>NodeList</code> object in the <code>childNodes</code> attribute |
765 |
of the node <em class=rfc2119>MUST</em> contain the |
of the node <em class=rfc2119>MUST</em> contain the |
766 |
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes |
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes |
794 |
read$B!>(Bonly.</p> |
read$B!>(Bonly.</p> |
795 |
|
|
796 |
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
797 |
<code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span> |
<code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is |
798 |
exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>. |
<a href="#read-only">read$B!>(Bonly</a>. Otherwise, it <em class=rfc2119>MUST</em> |
799 |
Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value |
set the specified value as the value associated to the attribute. No |
800 |
associated to the attribute. No normalization, relative reference resolution, |
normalization, relative reference resolution, or lexical validation is |
801 |
or lexical validation is performed. <span class=ed>@@ If the new |
performed. <span class=ed>@@ If the new value is <code>null</code>, should an e |
802 |
value is <code>null</code>, ...</span></p> |
mpty string be set?</span></p> |
803 |
|
|
804 |
<div class="note memo"> |
<div class="note memo"> |
805 |
<p>Setting an invalid identifier might make the node unserializable. |
<p>Setting an invalid identifier might make the node unserializable. |
817 |
read$B!>(Bonly.</p> |
read$B!>(Bonly.</p> |
818 |
|
|
819 |
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
820 |
<code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span> |
<code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is |
821 |
exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>. |
<a href="#read-only">read$B!>(Bonly</a>. Otherwise, it <em class=rfc2119>MUST</em> |
822 |
Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value |
set the specified value as the value associated to the attribute. No |
823 |
associated to the attribute. No normalization, or lexical validation is |
normalization, or lexical validation is performed. <span class=ed>@@ If the |
824 |
performed. <span class=ed>@@ If the new value is <code>null</code>, |
new value is <code>null</code>, should an empty string be set?</span></p> |
|
...</span></p> |
|
825 |
|
|
826 |
</div> |
</div> |
827 |
|
|
844 |
and <a href="#feature-XDoctype-3.0"><code>3.0</code></a> respectively (if the |
and <a href="#feature-XDoctype-3.0"><code>3.0</code></a> respectively (if the |
845 |
<a href="#DocumentType"><code>DocumentType</code></a> node supports the |
<a href="#DocumentType"><code>DocumentType</code></a> node supports the |
846 |
feature <code>Core</code> version <code>3.0</code> |
feature <code>Core</code> version <code>3.0</code> |
847 |
<span class=ed>[DOM3]</span>).</p> |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p> |
848 |
|
|
849 |
<div class="note memo"> |
<div class="note memo"> |
850 |
<p>This interface is a separated interface from the |
<p>This interface is a separated interface from the |
894 |
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> |
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> |
895 |
nodes belonging to the <code>DocumentType</code> node. The |
nodes belonging to the <code>DocumentType</code> node. The |
896 |
<code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be read$B!>(Bonly |
<code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be read$B!>(Bonly |
897 |
if and only if the node is read$B!>(Bonly. The <code>NamedNodeMap</code> |
if and only if the node is <a href="#read-only">read$B!>(Bonly</a>. The |
898 |
object <em class=rfc2119>MUST</em> be <a href="#live">live</a>.</p> |
<code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be |
899 |
|
<a href="#live">live</a>.</p> |
900 |
|
|
901 |
<p>If the <code>DocumentType</code> node is created during the process |
<p>If the <code>DocumentType</code> node is created during the process |
902 |
to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, the following |
to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, the following |
905 |
<em class=rfc2119>MUST</em> be so transformed that the object contains |
<em class=rfc2119>MUST</em> be so transformed that the object contains |
906 |
the <code>ElementTypeDefinition</code> nodes for the element types |
the <code>ElementTypeDefinition</code> nodes for the element types |
907 |
whose name is presented as the <code>Name</code> of the element type or |
whose name is presented as the <code>Name</code> of the element type or |
908 |
attribute definition list declarations processed by the <abbr>XML</abbr> |
attribute definition list declarations processed |
909 |
|
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
910 |
|
<a href="#ref-XML11">XML11</a>]</cite> by the <abbr>XML</abbr> |
911 |
processor. If there are more than one element type declarations for an |
processor. If there are more than one element type declarations for an |
912 |
element type, then the declarations other than the first one |
element type, then the declarations other than the first one |
913 |
<em class=rfc2119>MUST</em> be ignored for the purpose of constructing the |
<em class=rfc2119>MUST</em> be ignored for the purpose of constructing the |
1045 |
<code>null</code>.</p></dd> |
<code>null</code>.</p></dd> |
1046 |
<dt><dfn id=getNotationNode class=dom-method><code>getNotationNode</code></dfn>, |
<dt><dfn id=getNotationNode class=dom-method><code>getNotationNode</code></dfn>, |
1047 |
method</dt> |
method</dt> |
1048 |
<dd><p>Returns the <a href="#Notation"><code>Notation>/code></a> node |
<dd><p>Returns the <a href="#Notation"><code>Notation</code></a> node |
1049 |
with the specified name.</p> |
with the specified name.</p> |
1050 |
|
|
1051 |
<p>The |
<p>The |
1129 |
attribute of |
attribute of |
1130 |
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>, |
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>, |
1131 |
<a href="#Entity"><code>Entity</code></a>, and |
<a href="#Entity"><code>Entity</code></a>, and |
1132 |
<a href="#Notation"><code>Notation</code></a> interface contains the |
<a href="#Notation"><code>Notation</code></a> interfaces contain the |
1133 |
<a href="#DocumentType"><code>DocumentType</code></a> node to which the node |
<a href="#DocumentType"><code>DocumentType</code></a> node to which the node |
1134 |
is attached.</p> |
is attached.</p> |
1135 |
|
|
1158 |
belonging to the |
belonging to the |
1159 |
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node. |
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node. |
1160 |
The <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be |
The <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be |
1161 |
read$B!>(Bonly if and only if the node is read$B!>(Bonly. The |
read$B!>(Bonly if and only if the node is <a href="#read-only">read$B!>(Bonly</a>. |
1162 |
<code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be |
The <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be |
1163 |
<a href="#live">live</a>.</p> |
<a href="#live">live</a>.</p> |
1164 |
|
|
1165 |
<p>If the |
<p>If the |
1172 |
contains the |
contains the |
1173 |
<a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node |
<a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node |
1174 |
corresponding to the attribute definitions in the attribute definition |
corresponding to the attribute definitions in the attribute definition |
1175 |
list declarations processed by the <abbr>XML</abbr> processor and |
list declarations processed |
1176 |
|
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
1177 |
|
<a href="#ref-XML11">XML11</a>]</cite> by the <abbr>XML</abbr> processor and |
1178 |
associated to the element type represented by the node. If there are more |
associated to the element type represented by the node. If there are more |
1179 |
than one attribute definitions for an attribute, then the definitions other |
than one attribute definitions for an attribute, then the definitions other |
1180 |
than the first one <em class=rfc2119>MUST</em> be ignored for the purpose |
than the first one <em class=rfc2119>MUST</em> be ignored for the purpose |
1233 |
node cannot be a child of any node. An |
node cannot be a child of any node. An |
1234 |
<a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node |
<a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node |
1235 |
can have zero or more child nodes of same kinds as those allowed for |
can have zero or more child nodes of same kinds as those allowed for |
1236 |
<code>Attr</code> nodes <span class=ed>[DOM3]</span>.</p> |
<code>Attr</code> nodes |
1237 |
|
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p> |
1238 |
|
|
1239 |
<p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
<p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
1240 |
interface <em class=rfc2119>MUST</em> be implemented as following:</p> |
interface <em class=rfc2119>MUST</em> be implemented as following:</p> |
1288 |
then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p> |
then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p> |
1289 |
<dt><dfn id=declaredType class=dom-attr><code>declaredType</code></dfn> of type |
<dt><dfn id=declaredType class=dom-attr><code>declaredType</code></dfn> of type |
1290 |
<code>unsigned short</code></dt> |
<code>unsigned short</code></dt> |
1291 |
<dd><p>The declared type <span class=ed>@@ ref</span> of the attribute. |
<dd><p>The declared type |
1292 |
It is expected that this attribute contains a value from the definition group |
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
1293 |
|
<a href="#ref-XML11">XML11</a>]</cite> of the attribute. It is expected that |
1294 |
|
this attribute contains a value from the definition group |
1295 |
<a href="#DeclaredValueType"><code>DeclaredValueType</code></a>.</p> |
<a href="#DeclaredValueType"><code>DeclaredValueType</code></a>.</p> |
1296 |
|
|
1297 |
<p>On getting, the attribute <em class=rfc2119>MUST</em> return the |
<p>On getting, the attribute <em class=rfc2119>MUST</em> return the |
1298 |
value associated to this attribute.</p> |
value associated to this attribute.</p> |
1299 |
|
|
1300 |
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
1301 |
<code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span> |
<code>NO_MODIFICATION_ALLOWED_ERR</code> if the |
|
exception if the |
|
1302 |
<a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node |
<a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node |
1303 |
is read$B!>(Bonly <span class=ed>@@ ref</span>. Otherwise, it |
is <a href="#read-only">read$B!>(Bonly</a>. Otherwise, it |
1304 |
<em class=rfc2119>MUST</em> set the specified value as the value |
<em class=rfc2119>MUST</em> set the specified value as the value |
1305 |
associated to this attribute.</p> |
associated to this attribute.</p> |
1306 |
|
|
1323 |
<tbody> |
<tbody> |
1324 |
<tr> |
<tr> |
1325 |
<th scope=row><dfn id=NO_TYPE_ATTR class=dom-const><code>NO_TYPE_ATTR</code> |
<th scope=row><dfn id=NO_TYPE_ATTR class=dom-const><code>NO_TYPE_ATTR</code> |
1326 |
<td><code>0</code><td>No value <span class=ed>[INFOSET]</span>.</tr> |
<td><code>0</code><td><a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">No |
1327 |
|
value</a> |
1328 |
|
<cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>.</tr> |
1329 |
<tr> |
<tr> |
1330 |
<th scope=row><dfn id=CDATA_ATTR class=dom-const><code>CDATA_ATTR</code> |
<th scope=row><dfn id=CDATA_ATTR class=dom-const><code>CDATA_ATTR</code> |
1331 |
<td><code>1</code><td><code>CDATA</code> <span class=ed>[XML]</span>.</tr> |
<td><code>1</code><td><code>CDATA</code> |
1332 |
|
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
1333 |
|
<a href="#ref-XML11">XML11</a>]</cite>.</tr> |
1334 |
<tr> |
<tr> |
1335 |
<th scope=row><dfn id=ID_ATTR class=dom-const><code>ID_ATTR</code> |
<th scope=row><dfn id=ID_ATTR class=dom-const><code>ID_ATTR</code> |
1336 |
<td><code>2</code><td><code>ID</code> <span class=ed>[XML]</span>.</tr> |
<td><code>2</code><td><code>ID</code> |
1337 |
|
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
1338 |
|
<a href="#ref-XML11">XML11</a>]</cite>.</tr> |
1339 |
<tr> |
<tr> |
1340 |
<th scope=row><dfn id=IDREF_ATTR class=dom-const><code>IDREF_ATTR</code> |
<th scope=row><dfn id=IDREF_ATTR class=dom-const><code>IDREF_ATTR</code> |
1341 |
<td><code>3</code><td><code>IDREF</code> <span class=ed>[XML]</span>.</tr> |
<td><code>3</code><td><code>IDREF</code> |
1342 |
|
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
1343 |
|
<a href="#ref-XML11">XML11</a>]</cite>.</tr> |
1344 |
<tr> |
<tr> |
1345 |
<th scope=row><dfn id=IDREFS_ATTR class=dom-const><code>IDREFS_ATTR</code> |
<th scope=row><dfn id=IDREFS_ATTR class=dom-const><code>IDREFS_ATTR</code> |
1346 |
<td><code>4</code><td><code>IDREFS</code> <span class=ed>[XML]</span>.</tr> |
<td><code>4</code><td><code>IDREFS</code> |
1347 |
|
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
1348 |
|
<a href="#ref-XML11">XML11</a>]</cite>.</tr> |
1349 |
<tr> |
<tr> |
1350 |
<th scope=row><dfn id=ENTITY_ATTR class=dom-const><code>ENTITY_ATTR</code> |
<th scope=row><dfn id=ENTITY_ATTR class=dom-const><code>ENTITY_ATTR</code> |
1351 |
<td><code>5</code><td><code>ENTITY</code> <span class=ed>[XML]</span>.</tr> |
<td><code>5</code><td><code>ENTITY</code> |
1352 |
|
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
1353 |
|
<a href="#ref-XML11">XML11</a>]</cite>.</tr> |
1354 |
<tr> |
<tr> |
1355 |
<th scope=row><dfn id=ENTITIES_ATTR class=dom-const><code>ENTITIES_ATTR</code> |
<th scope=row><dfn id=ENTITIES_ATTR class=dom-const><code>ENTITIES_ATTR</code> |
1356 |
<td><code>6</code><td><code>ENTITIES</code> <span class=ed>[XML]</span>.</tr> |
<td><code>6</code><td><code>ENTITIES</code> |
1357 |
|
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
1358 |
|
<a href="#ref-XML11">XML11</a>]</cite>.</tr> |
1359 |
<tr> |
<tr> |
1360 |
<th scope=row><dfn id=NMTOKEN_ATTR class=dom-const><code>NMTOKEN_ATTR</code> |
<th scope=row><dfn id=NMTOKEN_ATTR class=dom-const><code>NMTOKEN_ATTR</code> |
1361 |
<td><code>7</code><td><code>NMTOKEN</code> <span class=ed>[XML]</span>.</tr> |
<td><code>7</code><td><code>NMTOKEN</code> |
1362 |
|
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
1363 |
|
<a href="#ref-XML11">XML11</a>]</cite>.</tr> |
1364 |
<tr> |
<tr> |
1365 |
<th scope=row><dfn id=NMTOKENS_ATTR class=dom-const><code>NMTOKENS_ATTR</code> |
<th scope=row><dfn id=NMTOKENS_ATTR class=dom-const><code>NMTOKENS_ATTR</code> |
1366 |
<td><code>8</code><td><code>NMTOKENS</code> <span class=ed>[XML]</span>.</tr> |
<td><code>8</code><td><code>NMTOKENS</code> |
1367 |
|
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
1368 |
|
<a href="#ref-XML11">XML11</a>]</cite>.</tr> |
1369 |
<tr> |
<tr> |
1370 |
<th scope=row><dfn id=NOTATION_ATTR class=dom-const><code>NOTATION_ATTR</code> |
<th scope=row><dfn id=NOTATION_ATTR class=dom-const><code>NOTATION_ATTR</code> |
1371 |
<td><code>9</code><td><code>NOTATION</code> <span class=ed>[XML]</span>.</tr> |
<td><code>9</code><td><code>NOTATION</code> |
1372 |
|
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
1373 |
|
<a href="#ref-XML11">XML11</a>]</cite>.</tr> |
1374 |
<tr> |
<tr> |
1375 |
<th scope=row><dfn id=ENUMERATION_ATTR class=dom-const><code>ENUMERATION_ATTR</code> |
<th scope=row><dfn id=ENUMERATION_ATTR class=dom-const><code>ENUMERATION_ATTR</code> |
1376 |
<td><code>10</code><td>Enumeration <span class=ed>[XML]</span>.</tr> |
<td><code>10</code><td>Enumeration |
1377 |
|
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
1378 |
|
<a href="#ref-XML11">XML11</a>]</cite>.</tr> |
1379 |
<tr> |
<tr> |
1380 |
<th scope=row><dfn id=UNKNOWN_ATTR class=dom-const><code>UNKNOWN_ATTR</code> |
<th scope=row><dfn id=UNKNOWN_ATTR class=dom-const><code>UNKNOWN_ATTR</code> |
1381 |
<td><code>11</code><td>Unknown, because no declaration for the attribute |
<td><code>11</code><td><a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">Unknown</a>, |
1382 |
has been read but the [all declaration processed] property |
because no declaration for the attribute has been read but the |
1383 |
<span class=ed>[INFOSET]</span> would be false.</tr> |
<a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.document">[all declaration processed]</a> |
1384 |
|
property |
1385 |
|
<cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite> |
1386 |
|
would be false.</tr> |
1387 |
</tbody> |
</tbody> |
1388 |
</table> |
</table> |
1389 |
|
|
1390 |
<p>If no attribute type information is available, or if the source |
<p>If no attribute type information is available, or if the source |
1391 |
of the information does not distinguish <q>no value</q> and <q>unknown</q> |
of the information does not distinguish |
1392 |
<span class=ed>[INFOSET]</span>, then the value |
<a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">no |
1393 |
|
value</a> and |
1394 |
|
<a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">unknown</a> |
1395 |
|
<cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>, |
1396 |
|
then the value |
1397 |
<a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a> |
<a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a> |
1398 |
<em class=rfc2119>MUST</em> be used.</p> |
<em class=rfc2119>MUST</em> be used.</p> |
1399 |
|
|
1405 |
set to <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</p> |
set to <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</p> |
1406 |
</div> |
</div> |
1407 |
|
|
1408 |
<p>If the source of the information does not distinguish <q>no value</q> |
<p>If the source of the information does not distinguish |
1409 |
and/or <q>unknown</q> <span class=ed>[INFOSET]</span> and |
<a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">no |
1410 |
<code>CDATA</code> <span class=ed>[XML]</span>, then the value |
value</a> and/or |
1411 |
|
<a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">unknown</a> |
1412 |
|
<cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite> and |
1413 |
|
<code>CDATA</code> |
1414 |
|
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
1415 |
|
<a href="#ref-XML11">XML11</a>]</cite>, then the value |
1416 |
<a href="#CDATA_ATTR"><code>CDATA_ATTR</code></a> <em class=rfc2119>MUST</em> |
<a href="#CDATA_ATTR"><code>CDATA_ATTR</code></a> <em class=rfc2119>MUST</em> |
1417 |
be used.</p> |
be used.</p> |
1418 |
|
|
1431 |
<em class=rfc2119>MAY</em> contain zero or more ordered strings, consist of |
<em class=rfc2119>MAY</em> contain zero or more ordered strings, consist of |
1432 |
zero or more characters respectively, possibly with duplications. The |
zero or more characters respectively, possibly with duplications. The |
1433 |
object <em class=rfc2119>MUST</em> be read$B!>(Bonly if and only if the node |
object <em class=rfc2119>MUST</em> be read$B!>(Bonly if and only if the node |
1434 |
is read$B!>(Bonly.</p> |
is <a href="#read-only">read$B!>(Bonly</a>.</p> |
1435 |
|
|
1436 |
<p>If the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
<p>If the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
1437 |
node is created during the process to create a <abbr>DOM</abbr> from an |
node is created during the process to create a <abbr>DOM</abbr> from an |
1463 |
the value associated to this attribute.</p> |
the value associated to this attribute.</p> |
1464 |
|
|
1465 |
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
1466 |
<code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span> |
<code>NO_MODIFICATION_ALLOWED_ERR</code> if the |
|
exception if the |
|
1467 |
<a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node |
<a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node |
1468 |
is read$B!>(Bonly <span class=ed>@@ ref</span>. Otherwise, it |
is <a href="#read-only">read$B!>(Bonly</a>. Otherwise, it |
1469 |
<em class=rfc2119>MUST</em> set the specified value as the value |
<em class=rfc2119>MUST</em> set the specified value as the value |
1470 |
associated to this attribute.</p> |
associated to this attribute.</p> |
1471 |
|
|
1492 |
<td><code>0</code><td>Unknown.</tr> |
<td><code>0</code><td>Unknown.</tr> |
1493 |
<tr> |
<tr> |
1494 |
<th scope=row><dfn id=FIXED_DEFAULT class=dom-const><code>FIXED_DEFAULT</code></dfn> |
<th scope=row><dfn id=FIXED_DEFAULT class=dom-const><code>FIXED_DEFAULT</code></dfn> |
1495 |
<td><code>1</code><td>Provided explicitly and fixed |
<td><code>1</code><td>Provided explicitly and only the value is allowed. |
1496 |
<span class=ed>@@ ref</span> to that value.</tr> |
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
1497 |
|
<a href="#ref-XML11">XML11</a>]</cite>.</tr> |
1498 |
<tr> |
<tr> |
1499 |
<th scope=row><dfn id=REQUIRED_DEFAULT class=dom-const><code>REQUIRED_DEFAULT</code></dfn> |
<th scope=row><dfn id=REQUIRED_DEFAULT class=dom-const><code>REQUIRED_DEFAULT</code></dfn> |
1500 |
<td><code>2</code><td>No default value and the attribute have to be |
<td><code>2</code><td>No default value and the attribute have to be |
1501 |
explicitly specified.</tr> |
explicitly specified.</tr> |
1502 |
<tr> |
<tr> |
1503 |
<th scope=row><dfn id=IMPLIED_DEFAULT class=dom-const><code>IMPLIED_DEFAULT</code></dfn> |
<th scope=row><dfn id=IMPLIED_DEFAULT class=dom-const><code>IMPLIED_DEFAULT</code></dfn> |
1504 |
<td><code>3</code><td>Implied <span class=ed>@@ ref</span>.</tr> |
<td><code>3</code><td>Implied |
1505 |
|
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
1506 |
|
<a href="#ref-XML11">XML11</a>]</cite>.</tr> |
1507 |
<tr> |
<tr> |
1508 |
<th scope=row><dfn id=EXPLICIT_DEFAULT class=dom-const><code>EXPLICIT_DEFAULT</code></dfn> |
<th scope=row><dfn id=EXPLICIT_DEFAULT class=dom-const><code>EXPLICIT_DEFAULT</code></dfn> |
1509 |
<td><code>4</code><td>Provided explicitly.</tr> |
<td><code>4</code><td>Provided explicitly.</tr> |
1549 |
read$B!>(Bonly.</p> |
read$B!>(Bonly.</p> |
1550 |
|
|
1551 |
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
1552 |
<code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span> |
<code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is |
1553 |
exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>. |
<a href="#read-only">read$B!>(Bonly</a>. Otherwise, it <em class=rfc2119>MUST</em> |
1554 |
Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value |
set the specified value as the value associated to the attribute. No lexical |
1555 |
associated to the attribute. No lexical validation is performed. The new |
validation is performed. The new value <em class=rfc2119>MAY</em> be |
1556 |
value <em class=rfc2119>MAY</em> be <code>null</code>.</p> |
<code>null</code>.</p> |
1557 |
|
|
1558 |
<dl> |
<dl> |
1559 |
<dt><dfn id=hasReplacementTree class=dom-attr><code>hasReplacementTree</code></dfn> |
<dt><dfn id=hasReplacementTree class=dom-attr><code>hasReplacementTree</code></dfn> |
1566 |
the value associated to this attribute.</p> |
the value associated to this attribute.</p> |
1567 |
|
|
1568 |
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
1569 |
<code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span> |
<code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is |
1570 |
exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>. |
<a href="#read-only">read$B!>(Bonly</a>. Otherwise, it |
1571 |
Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the |
<em class=rfc2119>MUST</em> set the specified value as the |
1572 |
value associated to this attribute.</p> |
value associated to this attribute.</p> |
1573 |
|
|
1574 |
<div class="note memo"> |
<div class="note memo"> |
1612 |
the value associated to this attribute.</p> |
the value associated to this attribute.</p> |
1613 |
|
|
1614 |
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
1615 |
<code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span> |
<code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is |
1616 |
exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>. |
<a href="#read-only">read$B!>(Bonly</a>. Otherwise, it |
1617 |
Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the |
<em class=rfc2119>MUST</em> set the specified value as the value associated |
1618 |
value associated to this attribute.</p> |
to this attribute.</p> |
1619 |
|
|
1620 |
<p>If the <a href="#Entity"><code>Entity</code></a> node is created during |
<p>If the <a href="#Entity"><code>Entity</code></a> node is created during |
1621 |
the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, |
the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, |
1651 |
|
|
1652 |
<dl> |
<dl> |
1653 |
<dt id=ref-DOM3CORE>DOM3CORE</dt> |
<dt id=ref-DOM3CORE>DOM3CORE</dt> |
1654 |
<dd class=ed>@@ W3C DOM Level 3 Core</dd> |
<dd><cite><a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407">Document |
1655 |
<dt id=ref-DOMDTDEF>DOMDTDEF</dt> |
Object Model (<abbr>DOM</abbr>) Level 3 Core Specification, Version |
1656 |
<dd class=ed>@@ manakai's extension to DOM for document type definitions</dd> |
1.0</a></cite>, <abbr>W3C</abbr> Recommendation, <time datetime=2004-04-07>7 |
1657 |
|
April 2004</time>. <em>This</em> version of the specification is referenced. |
1658 |
|
The latest version of the specification is available at |
1659 |
|
<code class=uri><<a href="http://www.w3.org/TR/DOM-Level-3-Core">http://www.w3.org/TR/DOM-Level-3-Core</a>></code>.</dd> |
1660 |
|
<dt id=ref-HTML5>HTML5</dt> |
1661 |
|
<dd><cite><a href="http://whatwg.org/html5"><abbr>HTML</abbr> 5</a></cite>, |
1662 |
|
<abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr> |
1663 |
|
Working Draft. Work in progress.</dd> |
1664 |
|
<dt id=ref-INFOSET>INFOSET</dt> |
1665 |
|
<dd><cite><a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204"><abbr>XML</abbr> |
1666 |
|
Information Set (Second Edition)</a></cite>, <abbr>W3C</abbr> Recommendation, |
1667 |
|
<time datetime=2004-02-04>4 February 2004</time>. <em>This</em> version of |
1668 |
|
the specification is referenced. The latest version of the specification is |
1669 |
|
available at |
1670 |
|
<code class=uri><<a href="http://www.w3.org/TR/xml-infoset">http://www.w3.org/TR/xml-infoset</a>></code>.</dd> |
1671 |
<dt id="ref-KEYWORDS">KEYWORDS</dt> |
<dt id="ref-KEYWORDS">KEYWORDS</dt> |
1672 |
<dd><cite><a href="urn:ietf:rfc:2119">Key words for use in |
<dd><cite><a href="urn:ietf:rfc:2119">Key words for use in |
1673 |
<abbr>RFCs</abbr> to Indicate Requirement Levels</a></cite>, |
<abbr>RFCs</abbr> to Indicate Requirement Levels</a></cite>, |
1676 |
14</a>, <abbr title="Request for Comments">RFC</abbr> 2119, |
14</a>, <abbr title="Request for Comments">RFC</abbr> 2119, |
1677 |
<time datetime=1997-03>March 1997</time>. |
<time datetime=1997-03>March 1997</time>. |
1678 |
<em>This</em> version of the specification is referenced.</dd> |
<em>This</em> version of the specification is referenced.</dd> |
|
<dt id=ref-INFOSET>INFOSET</dt> |
|
|
<dd class=ed>@@</dd> |
|
1679 |
<dt id=ref-XML10">XML10</dt> |
<dt id=ref-XML10">XML10</dt> |
1680 |
<dd><cite><a href="http://www.w3.org/TR/2006/REC-xml-20060816">Extensible |
<dd><cite><a href="http://www.w3.org/TR/2006/REC-xml-20060816">Extensible |
1681 |
Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>, |
Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>, |
1682 |
<abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August |
<abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August |
1683 |
2006</time>, edited in place <time datetime=2006-09-29>29 September |
2006</time>, edited in place <time datetime=2006-09-29>29 September |
1684 |
2006</time>. Tje latest version of the specification is available at |
2006</time>. <em>This</em> version of the specification is referenced. The |
1685 |
<code class=uri><<a href="http://www.w3.org/TR/xml">http://www.w3.org/TR/xml</a>></code>. |
latest version of the specification is available at |
1686 |
<em>This</em> version of the specification is referenced.</dd> |
<code class=uri><<a href="http://www.w3.org/TR/xml">http://www.w3.org/TR/xml</a>></code>.</dd> |
1687 |
<dt id=ref-XML11>XML11</dt> |
<dt id=ref-XML11>XML11</dt> |
1688 |
<dd class=ed>@@</dd> |
<dd><cite><a href="http://www.w3.org/TR/2006/REC-xml11-20060816/">Extensible |
1689 |
|
Markup Language (<abbr>XML</abbr>) 1.1 (Second Edition)</a></cite>, |
1690 |
|
<abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August |
1691 |
|
2006</time>, edited in place <time datetime=2006-09-29>29 September |
1692 |
|
2006</time>. <em>This version of the specification is referenced. The |
1693 |
|
latest version of the specification is available at |
1694 |
|
<code class=uri><<a href="http://www.w3.org/TR/xml11">http://www.w3.org/TR/xml11</a>></code>.</dd> |
1695 |
</dl> |
</dl> |
1696 |
</div> |
</div> |
1697 |
|
|
1698 |
<div id="informative-references" class="section informative reference"> |
<div id="informative-references" class="section informative reference"> |
1699 |
<h3>Non$B!>(Bnormative References</h3> |
<h3>Non$B!>(Bnormative References</h3> |
1700 |
|
|
1701 |
<dl class=ed> |
<dl> |
1702 |
<dt id=ref-CSS>CSS</dt> |
<dt id=ref-DOM1WD>DOM1WD</dt> |
1703 |
<dd><cite><a href="http://www.w3.org/TR/2007/CR-CSS21-20070719">Cascading |
<dd><cite><a href="http://www.w3.org/TR/WD-DOM-971209/">Document Object |
1704 |
Style Sheets Level 2 Revision 1 (<abbr>CSS</abbr> 2.1) |
Model Specification</a></cite>, <abbr>W3C</abbr> Working Draft, |
1705 |
Specification</a></cite>, |
<time datetime=1997-12-09>9 December 1998</time>.</dd> |
1706 |
<abbr title="World Wide Web Consortium">W3C</abbr> Candidate |
<dd><cite><a href="http://www.w3.org/TR/WD-DOM-19980318/">Document Object |
1707 |
Recommendation, <time datetime=2007-07-19>19 July 2007</time>. |
Model Specification</a></cite>, <abbr>W3C</abbr> Working Draft, |
1708 |
Work in progress. The latest version of the specification is |
<time datetime=1998-03-18>18 March 1998</time>.</dd> |
1709 |
available at |
<dd><cite><a href="http://www.w3.org/TR/1998/WD-DOM-19980416/">Document |
1710 |
<code class=URI><<a href="http://www.w3.org/TR/CSS21">http://www.w3.org/TR/CSS21</a>></code>.</dd> |
Object Model Specification, Version 1.0</a></cite>, <abbr>W3C</abbr> Working |
1711 |
<dt id=ref-CSSOM>CSSOM</dt> |
Draft, <time datetime=1998-04-16>16 April 1998</time>.</dd> |
1712 |
<dd><cite><a href="http://dev.w3.org/cvsweb/~checkout~/csswg/cssom/Overview.html?rev=1.55&content-type=text/html;%20charset=utf-8">Cascading |
<dt id=ref-DOM3AS>DOM3AS</dt> |
1713 |
Style Sheets Object Model (<abbr>CSSOM</abbr>)</a></cite>, |
<dd><cite><a href="http://www.w3.org/TR/2002/NOTE-DOM-Level-3-AS-20020725/">Document |
1714 |
<abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft, |
Object Model (<abbr>DOM</abbr>) Level 3 Abstract Schemas Specification, |
1715 |
<time datetime=2007-06-18>18 June 2007</time>. Work in progress. |
Version 1.0</a></cite>, <abbr>W3C</abbr> Note, <time datetime=2002-07-25>25 |
1716 |
The latest Editor's Draft of the specification is available at |
July 2002</time>. The latest version of the specification is available at |
1717 |
<code class=URI><<a href="http://dev.w3.org/csswg/cssom/Overview.html">http://dev.w3.org/csswg/cssom/Overview.html</a>></code>.</dd> |
<code class=uri><<a href="http://www.w3.org/TR/DOM-Level-3-AS">http://www.w3.org/TR/DOM-Level-3-AS</a>></code>.</dd> |
1718 |
<dt id=ref-HTML5>HTML5</dt> |
<dt id=ref-XSAPI>XSAPI</dt> |
1719 |
<dd><cite><a href="http://whatwg.org/html5"><abbr>HTML</abbr> 5</a></cite>, |
<dd><cite><a href="http://www.w3.org/Submission/2004/SUBM-xmlschema-api-20040309/"><abbr>XML</abbr> |
1720 |
<abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr> |
Schema <abbr>API</abbr></a></cite>, <abbr>W3C</abbr> Member Submission, |
1721 |
Working Draft. Work in progress.</dd> |
<time datetime=2004-03-09>9 March 2004</time>. The latest version of the |
1722 |
<dt id=ref-SAPI>SAPI</dt> |
specification is available at |
1723 |
<dd><cite><a href="http://dev.w3.org/cvsweb/~checkout~/2006/webapi/selectors-api/Overview.html?rev=1.28&content-type=text/html;%20charset=utf-8">Selectors <abbr>API</abbr></a></cite>, |
<code class=uri><<a href="http://www.w3.org/Submission/xmlschema-api/">http://www.w3.org/Submission/xmlschema-api/</a>></code>.</dd> |
|
<abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft, |
|
|
<time datetime=2007-08-29>29 August 2007</time>. Work in progress. |
|
|
The latest Editor's Draft of the specification is available at |
|
|
<code class=URI><<a href="http://dev.w3.org/2006/webapi/selectors-api/Overview.html">http://dev.w3.org/2006/webapi/selectors-api/Overview.html</a>></code>. |
|
|
The latest published version of the specification is available at |
|
|
<code class=URI><<a href="http://www.w3.org/TR/selectors-api/">http://www.w3.org/TR/selectors-api/</a>></code>.</dd> |
|
|
<dt id=XBL2>XBL2</dt> |
|
|
<dd><cite><a href="http://www.mozilla.org/projects/xbl/xbl2.html"><abbr>XBL</abbr> |
|
|
2.0</a></cite>, Mozilla.org, <time datetime=2007-03-15>15 Mar 2007</time>. |
|
|
Work in progress. The latest |
|
|
<abbr title="World Wide Web Consortium">W3C</abbr>$B!>(Bpublished |
|
|
version of the specification is available at |
|
|
<code class=URI><<a href="http://www.w3.org/TR/xbl/">http://www.w3.org/TR/xbl/</a>></code>.</dd> |
|
|
<dt id=ref-XML5>XML5</dt> |
|
|
<dd class=ed>@@</dd> |
|
1724 |
</dl> |
</dl> |
1725 |
</div> |
</div> |
1726 |
|
|