59 |
<div id="status" class="section"> |
<div id="status" class="section"> |
60 |
<h2>Status of This Document</h2> |
<h2>Status of This Document</h2> |
61 |
|
|
62 |
<p class=section-info><em>This section describes the status of this document |
<p class=section-info>This section describes the status of this document at the |
63 |
at the time of its publication. Other documents |
time of its publication. Other documents might supersede this document.</p> |
|
might supersede this document.</em></p> |
|
64 |
|
|
65 |
<p>This document is a working draft, produced as part of the |
<p>This document is a working draft, produced as part of the |
66 |
<a href="http://suika.fam.cx/www/manakai-core/doc/web/">manakai</a> |
<a href="http://suika.fam.cx/www/manakai-core/doc/web/">manakai</a> |
71 |
<p>Comments on this document are welcome and |
<p>Comments on this document are welcome and |
72 |
may be sent to the <a href="#author">author</a>.</p> |
may be sent to the <a href="#author">author</a>.</p> |
73 |
|
|
74 |
<p>Translations of thie document might be available. |
<p>Translations of this document might be available. |
75 |
The English version of the document is the only |
The English version of the document is the only |
76 |
normative version.</p> |
normative version.</p> |
77 |
</div> |
</div> |
155 |
is defined in the <abbr>DOM</abbr> Level 3 Core specification |
is defined in the <abbr>DOM</abbr> Level 3 Core specification |
156 |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p> |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p> |
157 |
|
|
158 |
<p class=ed>@@ ref to DOM Binding Spec</p> |
<p>The <em id=idl-fragment><abbr>IDL</abbr> fragments</em> in this document are |
159 |
|
to be interpreted as described in the <cite>Language Bindings for |
160 |
|
<abbr>DOM</abbr> Specifications</cite> specification |
161 |
|
<cite class="bibref normative">[<a href="#ref-DOMBIND">DOMBIND</a>]</cite>.</p> |
162 |
|
|
163 |
|
<p>Some <abbr>IDL</abbr> fragments are presented as <i>patch</i> to an |
164 |
|
<abbr>IDL</abbr> fragment defined in another document. They are to be |
165 |
|
interpreted as an instance of |
166 |
|
<a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMembers"><code>InterfaceMembers</code></a> |
167 |
|
<cite class="bibref normative">[<a href="#ref-DOMBIND">DOMBIND</a>]</cite>. |
168 |
|
If the <abbr>IDL</abbr> fragment to which the <i>patch</i> is applied has any |
169 |
|
instance of |
170 |
|
<a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a> |
171 |
|
with same |
172 |
|
<a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#prod-identifier"><code>identifier</code></a> |
173 |
|
part as that of any instance of |
174 |
|
<a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a> |
175 |
|
in the <i>patch</i>, then the former instance of |
176 |
|
<a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a> |
177 |
|
<em class=rfc2119>MUST</em> be ignored.</p> |
178 |
</div> |
</div> |
179 |
|
|
180 |
<div class=section id=conformance-categories> |
<div class=section id=conformance-categories> |
192 |
all the features in this document, the implementation have to implement |
all the features in this document, the implementation have to implement |
193 |
some version of <abbr>DOM</abbr> Core (e.g. <abbr>DOM</abbr> Level 3 Core |
some version of <abbr>DOM</abbr> Core (e.g. <abbr>DOM</abbr> Level 3 Core |
194 |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>) |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>) |
195 |
with one or more language binding (e.g. ECMAScript or Java binding <span class=ed>[BINDINGS]</span> or |
with one or more language binding (e.g. ECMAScript and Java bindings |
196 |
Perl binding <span class=ed>[PERLBINDING]</span>).</dd> |
<cite class="bibref normative">[<a href="#ref-DOMBIND">DOMBIND</a>]</cite> |
197 |
|
or Perl binding |
198 |
|
<cite class="bibref normative">[<a href="#ref-DOMPERL">DOMPERL</a>]</cite>). |
199 |
|
A conforming implementation <em class=rfc2119>MUST</em> also be a |
200 |
|
<a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#dfn-conforming-implementation">conforming |
201 |
|
implementation</a> of the <abbr>IDL</abbr> fragments in this document, as |
202 |
|
described in the <cite>Language Bindings for <abbr>DOM</abbr> |
203 |
|
Specifications</cite> specification |
204 |
|
<cite class="bibref normative">[<a href="#ref-DOMBIND">DOMBIND</a>]</cite>.</dd> |
205 |
<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 |
206 |
to <abbr>DOM</abbr> tree converter)</dt> |
to <abbr>DOM</abbr> tree converter)</dt> |
207 |
<dd>A software component that converts |
<dd>A software component that converts |
223 |
<abbr>DOM</abbr> Tree Converter</dt> |
<abbr>DOM</abbr> Tree Converter</dt> |
224 |
<dd>A software component that converts an <abbr>XML</abbr> information set |
<dd>A software component that converts an <abbr>XML</abbr> information set |
225 |
<cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite> |
<cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite> |
226 |
into a <abbr>DOM</abbr> tree. Note that this documetn does not define |
into a <abbr>DOM</abbr> tree. Note that this document does not define |
227 |
any particular way for the convertion, but it defines constraints for |
any particular way for the conversion, but it defines constraints for |
228 |
such processing.</dd> |
such processing.</dd> |
229 |
<dt id=category-dom-infoset><abbr>DOM</abbr> Tree to <abbr>XML</abbr> |
<dt id=category-dom-infoset><abbr>DOM</abbr> Tree to <abbr>XML</abbr> |
230 |
Information Set Converter</dt> |
Information Set Converter</dt> |
231 |
<dd>A software component that converts a <abbr>DOM</abbr> tree into |
<dd>A software component that converts a <abbr>DOM</abbr> tree into |
232 |
an <abbr>XML</abbr> information set. Note that this documetn does not define |
an <abbr>XML</abbr> information set. Note that this document does not define |
233 |
any particular way for the convertion, but it defines constraints for |
any particular way for the conversion, but it defines constraints for |
234 |
such processing.</dd> |
such processing.</dd> |
235 |
</dl> |
</dl> |
236 |
</div> |
</div> |
274 |
|
|
275 |
<p>The implementation of the |
<p>The implementation of the |
276 |
<a href="#Node"><code>Node</code></a> interface |
<a href="#Node"><code>Node</code></a> interface |
277 |
<em class=rfc2119>MUST</em> be modified as following:</p> |
<em class=rfc2119>MUST</em> be modified as the following |
278 |
|
<a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p> |
279 |
<pre class=idl><code>// Additions to the Node interface |
<pre class=idl><code>// Additions to the Node interface |
280 |
|
|
281 |
// Additions to the NodeType definition group |
// Additions to the NodeType definition group |
296 |
<a href="#Node"><code>Node</code></a> interface must behave as following:</p> |
<a href="#Node"><code>Node</code></a> interface must behave as following:</p> |
297 |
|
|
298 |
<dl> |
<dl> |
299 |
<dt><code id=attributes>attributes</code></dt> |
<dt><code id=attributes>attributes</code>, |
300 |
|
<code id=localName>localName</code>, |
301 |
|
<code id=namespaceURI>namespaceURI</code>, and |
302 |
|
<code id=prefix>prefix</code></dt> |
303 |
<dd> |
<dd> |
304 |
<p>On getting, the attribute <em class=rfc2119>MUST</em> return |
<p>On getting, the attributes <em class=rfc2119>MUST</em> return |
305 |
<code>null</code>.</p> |
<code>null</code>.</p> |
306 |
</dd> |
</dd> |
307 |
<dt><code id=baseURI>baseURI</code></dt> |
<dt><code id=baseURI>baseURI</code></dt> |
388 |
the values of the <code>DOMStringList</code> objects in the |
the values of the <code>DOMStringList</code> objects in the |
389 |
<a href="#allowedTokens"><code>allowedTokens</code></a> attributes |
<a href="#allowedTokens"><code>allowedTokens</code></a> attributes |
390 |
are equal, i.e. their <code>length</code> attribute values are equal and |
are equal, i.e. their <code>length</code> attribute values are equal and |
391 |
each string exists in a list is contained in another list (their indeces |
each string exists in a list is contained in another list (their indecies |
392 |
may be different), with an additional constraint that the number of the |
may be different), with an additional constraint that the number of the |
393 |
items that are equal to a string in a list is equal to the number |
items that are equal to a string in a list is equal to the number |
394 |
of the items equal to the string in another list.</p></li> |
of the items equal to the string in another list.</p></li> |
395 |
</ul></dd> |
</ul></dd> |
396 |
|
<dt><code id=manakaiLocalName>manakaiLocalName</code> |
397 |
|
<cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt> |
398 |
|
<dd><p class=section-info>This entry is applied only to implementations |
399 |
|
that support this attribute.</p> |
400 |
|
|
401 |
|
<p>On getting, the attributes <em class=rfc2119>MUST</em> return |
402 |
|
<code>null</code>.</p></dd> |
403 |
<dt><code id=lookupNamespaceURI>lookupNamespaceURI</code> and |
<dt><code id=lookupNamespaceURI>lookupNamespaceURI</code> and |
404 |
<code id=lookupPrefix>lookupPrefix</code></dt> |
<code id=lookupPrefix>lookupPrefix</code></dt> |
405 |
<dd><p>When invoked, the methods <em class=rfc2119>MUST</em> return |
<dd><p>When invoked, the methods <em class=rfc2119>MUST</em> return |
418 |
</dd> |
</dd> |
419 |
<dt><code id=nodeType>nodeType</code></dt> |
<dt><code id=nodeType>nodeType</code></dt> |
420 |
<dd> |
<dd> |
421 |
<p>On getting, the attribute <em class=rfc2119>MUST</em> return |
<p>On getting, the attribute <!--<em class=rfc2119>MUST</em>--> returns |
422 |
|
<!-- NOTE: No MUST, to avoid circular reference (nodeType==8100[12] |
423 |
|
is defined that they MUST implement ElementType|AttributeDefinition). --> |
424 |
<a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a> |
<a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a> |
425 |
(if the node is an |
(if the node is an |
426 |
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) or |
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) or |
530 |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p> |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p> |
531 |
|
|
532 |
<p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface |
<p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface |
533 |
<em class=rfc2119>MUST</em> be implemented as following:</p> |
<em class=rfc2119>MUST</em> be implemented as the following |
534 |
|
<a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p> |
535 |
<pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> { |
<pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> { |
536 |
DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a> |
DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a> |
537 |
(in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>) |
(in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>) |
576 |
<a href="#publicId"><code>publicId</code></a>, and |
<a href="#publicId"><code>publicId</code></a>, and |
577 |
<a href="#systemId"><code>systemId</code></a></dt> |
<a href="#systemId"><code>systemId</code></a></dt> |
578 |
<dd>Empty strings.</dd> |
<dd>Empty strings.</dd> |
|
<dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt> |
|
|
<dd><code>false</code>.</dd> |
|
579 |
<dt><code>nodeName</code></dt> |
<dt><code>nodeName</code></dt> |
580 |
<dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd> |
<dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd> |
581 |
<dt><code>ownerDocument</code></dt> |
<dt><code>ownerDocument</code></dt> |
582 |
<dd>The <a href="#Document"><code>Document</code></a> node over which the |
<dd>The <a href="#Document"><code>Document</code></a> node over which the |
583 |
method is invoked.</dd> |
method is invoked.</dd> |
584 |
</dl> |
</dl> |
585 |
|
<p>The returned node <em class=rfc2119>MUST NOT</em> be marked as |
586 |
|
<a href="#read-only">read$B!>(Bonly</a>.</p> |
587 |
<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 |
588 |
containing five general entity declarations: <code>amp</code>, |
containing five general entity declarations: <code>amp</code>, |
589 |
<code>lt</code>, <code>gt</code>, <code>quot</code>, and |
<code>lt</code>, <code>gt</code>, <code>quot</code>, and |
605 |
<dl> |
<dl> |
606 |
<dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt> |
<dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt> |
607 |
<dd>An empty <code>NamedNodeMap</code> object.</dd> |
<dd>An empty <code>NamedNodeMap</code> object.</dd> |
|
<dt><a href="#attributes"><code>attributes</code></a>, |
|
|
<code>parentNode</code></dt> |
|
|
<dd><code>null</code>.</dd> |
|
608 |
<dt><code>childNodes</code></dt> |
<dt><code>childNodes</code></dt> |
609 |
<dd>An empty <code>NodeList</code> object.</dd> |
<dd>An empty <code>NodeList</code> object.</dd> |
|
<dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt> |
|
|
<dd><code>false</code>.</dd> |
|
610 |
<dt><a href="#nodeName"><code>nodeName</code></a></dt> |
<dt><a href="#nodeName"><code>nodeName</code></a></dt> |
611 |
<dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd> |
<dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd> |
612 |
<dt><code>ownerDocument</code></dt> |
<dt><code>ownerDocument</code></dt> |
613 |
<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> |
614 |
<dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a></dt> |
<dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a> |
615 |
|
and <code>parentNode</code></dt> |
616 |
<dd><code>null</code>.</dd> |
<dd><code>null</code>.</dd> |
|
<dt class=ed>@@ Ensure all attributes are defined</dt> |
|
617 |
</dl> |
</dl> |
618 |
|
<p>The returned node <em class=rfc2119>MUST NOT</em> be marked as |
619 |
|
<a href="#read-only">read$B!>(Bonly</a>.</p> |
620 |
</dd> |
</dd> |
621 |
<dt><dfn id=createAttributeDefinition class=dom-method><code>createAttributeDefinition</code></dfn>, |
<dt><dfn id=createAttributeDefinition class=dom-method><code>createAttributeDefinition</code></dfn>, |
622 |
method</dt> |
method</dt> |
634 |
<dl> |
<dl> |
635 |
<dt><a href="#allowedTokens"><code>allowedTokens</code></a></dt> |
<dt><a href="#allowedTokens"><code>allowedTokens</code></a></dt> |
636 |
<dd>An empty <code>DOMStringList</code> object.</dd> |
<dd>An empty <code>DOMStringList</code> object.</dd> |
|
<dt><a href="#attributes"><code>attributes</code></a>, |
|
|
<a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a>, |
|
|
and <code>parentNode</code></dt> |
|
|
<dd><code>null</code>.</dd> |
|
637 |
<dt><code>childNodes</code></dt> |
<dt><code>childNodes</code></dt> |
638 |
<dd>An empty <code>NodeList</code> object.</dd> |
<dd>An empty <code>NodeList</code> object.</dd> |
639 |
<dt><a href="#declaredType"><code>declaredType</code></a></dt> |
<dt><a href="#declaredType"><code>declaredType</code></a></dt> |
640 |
<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> |
641 |
<dt><a href="#defaultType"><code>defaultType</code></a></dt> |
<dt><a href="#defaultType"><code>defaultType</code></a></dt> |
642 |
<dd><a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</dd> |
<dd><a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</dd> |
|
<dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt> |
|
|
<dd><code>false</code>.</dd> |
|
643 |
<dt><a href="#nodeName"><code>nodeName</code></a></dt> |
<dt><a href="#nodeName"><code>nodeName</code></a></dt> |
644 |
<dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd> |
<dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd> |
645 |
<dt><code>ownerDocument</code></dt> |
<dt><code>ownerDocument</code></dt> |
646 |
<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> |
647 |
<dt class=ed>@@ Ensure all attributes are defined</dt> |
<dt><a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a> |
648 |
|
and <code>parentNode</code></dt> |
649 |
|
<dd><code>null</code>.</dd> |
650 |
</dl> |
</dl> |
651 |
|
<p>The returned node <em class=rfc2119>MUST NOT</em> be marked as |
652 |
|
<a href="#read-only">read$B!>(Bonly</a>.</p> |
653 |
|
|
654 |
<!-- This requirement, if not droped, should be part of xml-id spec. |
<!-- This requirement, if not droped, should be part of xml-id spec. |
655 |
<div class=ed> |
<div class=ed> |
674 |
an <a href="#Entity"><code>Entity</code></a> node with the following |
an <a href="#Entity"><code>Entity</code></a> node with the following |
675 |
attributes:</p> |
attributes:</p> |
676 |
<dl> |
<dl> |
|
<dt><code>attributes</code>, |
|
|
<a href="#notationName"><code>notationName</code></a>, |
|
|
<a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>, |
|
|
and <code>parentNode</code></dt> |
|
|
<dd><code>null</code>.</dd> |
|
677 |
<dt><code>childNodes</code></dt> |
<dt><code>childNodes</code></dt> |
678 |
<dd>An empty <code>NodeList</code> object.</dd> |
<dd>An empty <code>NodeList</code> object.</dd> |
679 |
<dt><code>manakaiDeclarationBaseURI</code>, |
<dt><code>manakaiDeclarationBaseURI</code>, |
680 |
<code>manakaiEntityBaseURI</code>, and |
<code>manakaiEntityBaseURI</code>, and <code>manakaiEntityURI</code> |
681 |
<code>manakaiEntityURI</code> <span class=ed>@@ ref</span></dt> |
<cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt> |
682 |
<dd>No explicit value is set.</dd> |
<dd><p class=section-info>This entry is applied only to implementations |
683 |
|
that support these attributes.</p> |
684 |
|
|
685 |
|
<p>No explicit value is set.</p></dd> |
686 |
<dt><a href="#hasReplacementTree"><code>hasReplacementTree</code></a> and |
<dt><a href="#hasReplacementTree"><code>hasReplacementTree</code></a> and |
687 |
<code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt> |
<a href="#isExternallyDeclared"><code>isExternallyDeclared</code></a></dt> |
688 |
<dd><code>false</code>.</dd> |
<dd><p><code>false</code>.</p></dd> |
689 |
<dt><code>nodeName</code></dt> |
<dt><code>nodeName</code></dt> |
690 |
<dd><a href="#createGeneralEntity-name"><var>name</var></a>.</dd> |
<dd><a href="#createGeneralEntity-name"><var>name</var></a>.</dd> |
691 |
<dd> |
<dd> |
700 |
with its <code>nodeName</code> attribute set to <code>amp</code>.</p> |
with its <code>nodeName</code> attribute set to <code>amp</code>.</p> |
701 |
</div> |
</div> |
702 |
</dd> |
</dd> |
703 |
|
<dt><a href="#notationName"><code>notationName</code></a>, |
704 |
|
<a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>, |
705 |
|
and <code>parentNode</code></dt> |
706 |
|
<dd><code>null</code>.</dd> |
707 |
<dt><code>ownerDocument</code></dt> |
<dt><code>ownerDocument</code></dt> |
708 |
<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> |
709 |
<dt><a href="#publicId"><code>publicId</code></a> and |
<dt><a href="#publicId"><code>publicId</code></a> and |
710 |
<a href="#systemId"><code>systemId</code></a></dt> |
<a href="#systemId"><code>systemId</code></a></dt> |
711 |
<dd><code>null</code>.</dd> |
<dd><code>null</code>.</dd> |
712 |
<dd class=ed>@@ publicId and systemId should be empty string?</dd> |
<dd class=ed>@@ publicId and systemId should be empty string?</dd> |
|
<dt class=ed>@@ Ensure all attributes are defined</dd> |
|
713 |
</dl> |
</dl> |
714 |
</dd> |
<p>The returned node <em class=rfc2119>MUST NOT</em> be marked as |
715 |
|
<a href="#read-only">read$B!>(Bonly</a>.</p></dd> |
716 |
<dt><dfn id=createNotation class=dom-method><code>createNotation</code></dfn>, |
<dt><dfn id=createNotation class=dom-method><code>createNotation</code></dfn>, |
717 |
method</dt> |
method</dt> |
718 |
<dd> |
<dd> |
724 |
<p>When invoked, the method <em class=rfc2119>MUST</em> create and return |
<p>When invoked, the method <em class=rfc2119>MUST</em> create and return |
725 |
a <code>Notation</code> node with the following attributes:</p> |
a <code>Notation</code> node with the following attributes:</p> |
726 |
<dl> |
<dl> |
|
<dt><code>attributes</code>, |
|
|
<a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>, |
|
|
and <code>parentNode</code></dt> |
|
|
<dd><code>null</code>.</dd> |
|
727 |
<dt><code>childNodes</code></dt> |
<dt><code>childNodes</code></dt> |
728 |
<dd>An empty <code>NodeList</code> object.</dd> |
<dd>An empty <code>NodeList</code> object.</dd> |
729 |
<dt><code>manakaiDeclarationBaseURI</code></dt> |
<dt><code>manakaiDeclarationBaseURI</code> |
730 |
<dd>No explicit value is set.</dd> |
<cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt> |
731 |
<dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt> |
<dd><p class=section-info>This entry is applied only to implementations |
732 |
<dd><code>false</code>.</dd> |
that support these attributes.</p> |
733 |
|
|
734 |
|
<p>No explicit value is set.</p></dd> |
735 |
<dt><code>nodeName</code></dt> |
<dt><code>nodeName</code></dt> |
736 |
<dd><a href="#createNotation-name"><var>name</var></a>.</dd> |
<dd><a href="#createNotation-name"><var>name</var></a>.</dd> |
737 |
<dt><code>ownerDocument</code></dt> |
<dt><code>ownerDocument</code></dt> |
738 |
<dd>The <code>Document</code> node over which the method is invoked.</dd> |
<dd><p>The <a href="#Document"><code>Document</code></a> node over which |
739 |
|
the method is invoked.</p></dd> |
740 |
|
<dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a> |
741 |
|
and <code>parentNode</code></dt> |
742 |
|
<dd><code>null</code>.</dd> |
743 |
<dt><a href="#publicId"><code>publicId</code></a> and |
<dt><a href="#publicId"><code>publicId</code></a> and |
744 |
<a href="#systemId"><code>systemId</code></a></dt> |
<a href="#systemId"><code>systemId</code></a></dt> |
745 |
<dd><code>null</code>.</dd> |
<dd><code>null</code>.</dd> |
746 |
<dd class=ed>@@ publicId and systemId should be empty string?</dd> |
<dd class=ed>@@ publicId and systemId should be empty string?</dd> |
|
<dt class=ed>@@ Ensure all attributes are defined</dt> |
|
747 |
</dl> |
</dl> |
748 |
</dd> |
<p>The returned node <em class=rfc2119>MUST NOT</em> be marked as |
749 |
|
<a href="#read-only">read$B!>(Bonly</a>.</p></dd> |
750 |
</dl> |
</dl> |
751 |
|
|
752 |
<p>These methods <em class=rfc2119>MUST</em> raise an |
<p>These methods <em class=rfc2119>MUST</em> raise an |
776 |
|
|
777 |
<p>A <a href="#DocumentType"><code>DocumentType</code></a> interface |
<p>A <a href="#DocumentType"><code>DocumentType</code></a> interface |
778 |
<em class=rfc2119>MAY</em> contain zero or more |
<em class=rfc2119>MAY</em> contain zero or more |
779 |
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> |
<code>ProcessingInstruction</code> nodes in the <code>NodeList</code> object |
780 |
nodes in the <code>NodeList</code> object contained in the |
contained in the <code>childNodes</code> attribute of the |
|
<code>childNodes</code> attribute of the |
|
781 |
<a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
<a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
782 |
|
|
783 |
<p>If the <a href="#DocumentType"><code>DocumentType</code></a> node is created |
<p>If the <a href="#DocumentType"><code>DocumentType</code></a> node is created |
784 |
during the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> |
during the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> |
785 |
document, the <code>NodeList</code> object in the <code>childNodes</code> |
document, the <code>NodeList</code> object in the <code>childNodes</code> |
786 |
object <em class=rfc2119>MUST</em> contains the |
object <em class=rfc2119>MUST</em> contains the |
787 |
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> |
<code>ProcessingInstruction</code> nodes representing the processing |
788 |
nodes representing the processing instructions in the document type |
instructions in the document type definition of the document processed |
|
definition of the document processed |
|
789 |
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
790 |
<a href="#ref-XML11">XML11</a>]</cite> by the <abbr>XML</abbr> processor. If |
<a href="#ref-XML11">XML11</a>]</cite> by the <abbr>XML</abbr> processor. If |
791 |
the <a href="#DocumentType"><code>DocumentType</code></a> node is marked as |
the <a href="#DocumentType"><code>DocumentType</code></a> node is marked as |
800 |
<cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>, |
<cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>, |
801 |
the <code>NodeList</code> object in the <code>childNodes</code> attribute |
the <code>NodeList</code> object in the <code>childNodes</code> attribute |
802 |
of the node <em class=rfc2119>MUST</em> contain the |
of the node <em class=rfc2119>MUST</em> contain the |
803 |
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes |
<code>ProcessingInstruction</code> nodes created from any |
804 |
created from the processing instruction information items in the list in the |
<a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.pi">processing |
805 |
[children] property of the document type declaration item in the same |
instruction information items</a> in the list in the [children] property of the |
806 |
order.</p> |
<a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.doctype">document |
807 |
|
type declaration item</a> in the same order.</p> |
808 |
|
|
809 |
<p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is mapped to |
<p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is mapped to |
810 |
a document type declaration information item, the list in the [children] |
a document type declaration information item, the list in the [children] |
811 |
property <em class=rfc2119>MUST</em> contain the processng instruction |
property <em class=rfc2119>MUST</em> contain the processng instruction |
812 |
information items created from the |
information items created from the <code>ProcessingInstruction</code> nodes |
|
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes |
|
813 |
in the <code>NodeList</code> object in the <code>childNodes</code> attribute |
in the <code>NodeList</code> object in the <code>childNodes</code> attribute |
814 |
of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
815 |
|
|
816 |
<p>The implementation of the |
<p>The implementation of the |
817 |
<a href="#DocumentType"><code>DocumentType</code></a> interface |
<a href="#DocumentType"><code>DocumentType</code></a> interface |
818 |
<em class=rfc2119>MUST</em> be modified as following:</p> |
<em class=rfc2119>MUST</em> be modified as the following |
819 |
|
<a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p> |
820 |
<pre class=idl><code>// Modifications to the DocumentType interface |
<pre class=idl><code>// Modifications to the DocumentType interface |
821 |
attribute DOMString <a href="#publicId">publicId</a>; |
attribute DOMString <a href="#publicId">publicId</a>; |
822 |
attribute DOMString <a href="#systemId">systemId</a>; |
attribute DOMString <a href="#systemId">systemId</a>; |
836 |
<a href="#read-only">read$B!>(Bonly</a>. Otherwise, it <em class=rfc2119>MUST</em> |
<a href="#read-only">read$B!>(Bonly</a>. Otherwise, it <em class=rfc2119>MUST</em> |
837 |
set the specified value as the value associated to the attribute. No |
set the specified value as the value associated to the attribute. No |
838 |
normalization, relative reference resolution, or lexical validation is |
normalization, relative reference resolution, or lexical validation is |
839 |
performed. <span class=ed>@@ If the new value is <code>null</code>, should an e |
performed. <span class=ed>@@ If the new value is <code>null</code>, should an |
840 |
mpty string be set?</span></p> |
empty string be set?</span></p> |
841 |
|
|
842 |
<div class="note memo"> |
<div class="note memo"> |
843 |
<p>Setting an invalid identifier might make the node unserializable. |
<p>Setting an invalid identifier might make the node unserializable. |
844 |
Setting a public identifier while leaveing system identifier unspecified |
Setting a public identifier while leaving system identifier unspecified |
845 |
would also make the <a href="#DocumentType"><code>DocumentType</code></a> |
would also make the <a href="#DocumentType"><code>DocumentType</code></a> |
846 |
or <a href="#Entity"><code>Entity</code></a> node unserializable.</p> |
or <a href="#Entity"><code>Entity</code></a> node unserializable.</p> |
847 |
</div> |
</div> |
884 |
feature <code>Core</code> version <code>3.0</code> |
feature <code>Core</code> version <code>3.0</code> |
885 |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p> |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p> |
886 |
|
|
|
<div class="note memo"> |
|
|
<p>This interface is a separated interface from the |
|
|
<a href="#DocumentType"><code>DocumentType</code></a>, not a set of extensions |
|
|
to the <a href="#DocumentType"><code>DocumentType</code></a>, |
|
|
for the historical reason.</p> |
|
|
|
|
|
<p class=ed>Should the interface be merged with |
|
|
<a href="#DocumentType"><code>DocumentType</code></a>?</p> |
|
|
</div> |
|
|
|
|
887 |
<p>The |
<p>The |
888 |
<a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a> |
<a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a> |
889 |
interface <em class=rfc2119>MUST</em> be implemented as following:</p> |
interface <em class=rfc2119>MUST</em> be implemented as the following |
890 |
|
<a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p> |
891 |
<pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> { |
<pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> { |
892 |
readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>; |
readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>; |
893 |
readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>; |
readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>; |
948 |
<a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
<a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
949 |
|
|
950 |
<p>On getting, the attribute <em class=rfc2119>MUST</em> return the |
<p>On getting, the attribute <em class=rfc2119>MUST</em> return the |
951 |
same value as the <code>entities</code> attribute (defined in the |
same value as the <code id=entities>entities</code> attribute (defined in the |
952 |
<a href="#DocumentType"><code>DocumentType</code></a> interface) of the same |
<a href="#DocumentType"><code>DocumentType</code></a> interface) of the same |
953 |
node.</p> |
node.</p> |
954 |
|
|
1038 |
<a href="#elementTypes"><code>elementTypes</code></a> attribute of the |
<a href="#elementTypes"><code>elementTypes</code></a> attribute of the |
1039 |
node. If there is no such node, it <em class=rfc2119>MUST</em> return |
node. If there is no such node, it <em class=rfc2119>MUST</em> return |
1040 |
<code>null</code>.</p></dd> |
<code>null</code>.</p></dd> |
|
<dt><dfn id=getElementTypeDefinitionNode class=dom-method><code>getElementTypeDefinitionNode</code></dfn>, |
|
|
method</dt> |
|
|
<dd><p>Returns the |
|
|
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node |
|
|
with the specified name.</p> |
|
|
|
|
|
<p>The |
|
|
<dfn id=getElementTypeDefinitionNode-name class=dom-param><var>name</var></dfn> |
|
|
parameter is the name of the element type.</p> |
|
|
|
|
|
<p>When invoked, the method <em class=rfc2119>MUST</em> return the |
|
|
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node, |
|
|
whose <a href="#nodeName"><code>nodeName</code></a> is equal to |
|
|
<a href="#getElementTypeDefinitionNode-name"><var>name</var></a>, in the |
|
|
<code>NamedNodeMap</code> object in the |
|
|
<a href="#elementTypes"><code>elementTypes</code></a> attribute of the |
|
|
node. If there is no such node, it <em class=rfc2119>MUST</em> return |
|
|
<code>null</code>.</p></dd> |
|
1041 |
<dt><dfn id=getGeneralEntityNode class=dom-method><code>getGeneralEntityNode</code></dfn>, |
<dt><dfn id=getGeneralEntityNode class=dom-method><code>getGeneralEntityNode</code></dfn>, |
1042 |
method</dt> |
method</dt> |
1043 |
<dd><p>Returns the <a href="#Entity"><code>Entity</code></a> node |
<dd><p>Returns the <a href="#Entity"><code>Entity</code></a> node |
1044 |
with the specified name.</p> |
with the specified name.</p> |
1045 |
|
|
1046 |
<p>The <dfn id=getEntityNode-name class=dom-param><var>name</var></dfn> |
<p>The |
1047 |
|
<dfn id=getGeneralEntityNode-name class=dom-param><var>name</var></dfn> |
1048 |
parameter is the name of the general entity.</p> |
parameter is the name of the general entity.</p> |
1049 |
|
|
1050 |
<p>When invoked, the method <em class=rfc2119>MUST</em> return the |
<p>When invoked, the method <em class=rfc2119>MUST</em> return the |
1051 |
<a href="#Entity"><code>Entity</code></a> node, |
<a href="#Entity"><code>Entity</code></a> node, |
1052 |
whose <a href="#nodeName"><code>nodeName</code></a> is equal to |
whose <a href="#nodeName"><code>nodeName</code></a> is equal to |
1053 |
<a href="#getEntityNode-name"><var>name</var></a>, in the |
<a href="#getGeneralEntityNode-name"><var>name</var></a>, in the |
1054 |
<code>NamedNodeMap</code> object in the |
<code>NamedNodeMap</code> object in the |
1055 |
<a href="#entities"><code>entities</code></a> attribute of the |
<a href="#entities"><code>entities</code></a> attribute of the |
1056 |
node. If there is no such node, it <em class=rfc2119>MUST</em> return |
node. If there is no such node, it <em class=rfc2119>MUST</em> return |
1074 |
<code>null</code>.</p></dd> |
<code>null</code>.</p></dd> |
1075 |
<dt><dfn id=setElementTypeDefinitionNode class=dom-method><code>setElementTypeDefinitionNode</code></dfn>, |
<dt><dfn id=setElementTypeDefinitionNode class=dom-method><code>setElementTypeDefinitionNode</code></dfn>, |
1076 |
method</dt> |
method</dt> |
1077 |
<dd class=ed>@@</dd> |
<dd><p>Associate an |
1078 |
|
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> |
1079 |
|
node with the <a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
1080 |
|
|
1081 |
|
<p>The |
1082 |
|
<dfn id=setElementTypeDefinitionNode-node class=dom-param><var>node</var></dfn> |
1083 |
|
parameter is the node to associate.</p> |
1084 |
|
|
1085 |
|
<p>When invoked, the method <em class=rfc2119>MUST</em> follow the rules |
1086 |
|
to <a href="#algorithm-attach-node">attach a node</a>, where |
1087 |
|
<a href="#attach-node-n"><var>n</var></a> is the |
1088 |
|
<a href="#DocumentType"><code>DocumentType</code></a> node, |
1089 |
|
<a href="#attach-node-l"><var>l</var></a> is the |
1090 |
|
<a href="#elementTypes"><code>elementTypes</code></a> attribute value of the |
1091 |
|
<a href="#DocumentType"><code>DocumentType</code></a> node, |
1092 |
|
<a href="#attach-node-node"><var>node</var></a> is the |
1093 |
|
<a href="#setElementTypeDefinitionNode-node"><var>node</var></a>, and |
1094 |
|
<a href="#attach-node-owner-attr"><var>owner-attr</var></a> is the |
1095 |
|
<a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a> |
1096 |
|
attribute.</p></dd> |
1097 |
<dt><dfn id=setGeneralEntityNode class=dom-method><code>setGeneralEntityNode</code></dfn>, |
<dt><dfn id=setGeneralEntityNode class=dom-method><code>setGeneralEntityNode</code></dfn>, |
1098 |
method</dt> |
method</dt> |
1099 |
<dd class=ed>@@</dd> |
<dd><p>Associate an <a href="#Entity"><code>Entity</code></a> |
1100 |
|
node with the <a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
1101 |
|
|
1102 |
|
<p>The |
1103 |
|
<dfn id=setGeneralEntityNode-node class=dom-param><var>node</var></dfn> |
1104 |
|
parameter is the node to associate.</p> |
1105 |
|
|
1106 |
|
<p>When invoked, the method <em class=rfc2119>MUST</em> follow the rules |
1107 |
|
to <a href="#algorithm-attach-node">attach a node</a>, where |
1108 |
|
<a href="#attach-node-n"><var>n</var></a> is the |
1109 |
|
<a href="#DocumentType"><code>DocumentType</code></a> node, |
1110 |
|
<a href="#attach-node-l"><var>l</var></a> is the |
1111 |
|
<a href="#entities"><code>entities</code></a> attribute value of the |
1112 |
|
<a href="#DocumentType"><code>DocumentType</code></a> node, |
1113 |
|
<a href="#attach-node-node"><var>node</var></a> is the |
1114 |
|
<a href="#setGeneralEntityNode-node"><var>node</var></a>, and |
1115 |
|
<a href="#attach-node-owner-attr"><var>owner-attr</var></a> is the |
1116 |
|
<a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a> |
1117 |
|
attribute.</p></dd> |
1118 |
<dt><dfn id=setNotationNode class=dom-method><code>setNotationNode</code></dfn>, |
<dt><dfn id=setNotationNode class=dom-method><code>setNotationNode</code></dfn>, |
1119 |
method</dt> |
method</dt> |
1120 |
<dd class=ed>@@</dd> |
<dd><p>Associate an <a href="#Notation"><code>Notation</code></a> |
1121 |
|
node with the <a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
1122 |
|
|
1123 |
|
<p>The <dfn id=setNotationNode-node class=dom-param><var>node</var></dfn> |
1124 |
|
parameter is the node to associate.</p> |
1125 |
|
|
1126 |
|
<p>When invoked, the method <em class=rfc2119>MUST</em> follow the rules |
1127 |
|
to <a href="#algorithm-attach-node">attach a node</a>, where |
1128 |
|
<a href="#attach-node-n"><var>n</var></a> is the |
1129 |
|
<a href="#DocumentType"><code>DocumentType</code></a> node, |
1130 |
|
<a href="#attach-node-l"><var>l</var></a> is the |
1131 |
|
<a href="#notations"><code>notations</code></a> attribute value of the |
1132 |
|
<a href="#DocumentType"><code>DocumentType</code></a> node, |
1133 |
|
<a href="#attach-node-node"><var>node</var></a> is the |
1134 |
|
<a href="#setNotationNode-node"><var>node</var></a>, and |
1135 |
|
<a href="#attach-node-owner-attr"><var>owner-attr</var></a> is the |
1136 |
|
<a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a> |
1137 |
|
attribute.</p></dd> |
1138 |
</dl> |
</dl> |
1139 |
|
|
1140 |
|
<p>When a <dfn id=algorithm-attach-node title="attach a node">node is |
1141 |
|
attached</dfn>, the rules below, with parameters |
1142 |
|
<dfn id=attach-node-n><var>n</var></dfn>, |
1143 |
|
<dfn id=attach-node-l><var>l</var></dfn>, |
1144 |
|
<dfn id=attach-node-node><var>node</var></dfn>, and |
1145 |
|
<dfn id=attach-node-owner-attr><var>owner-attr</var></dfn>, |
1146 |
|
<em class=rfc2119>MUST</em> be followed:</p> |
1147 |
|
<ol> |
1148 |
|
<li><p>Let |
1149 |
|
<dfn id=attach-node-r><var>r</var></dfn> be the node in |
1150 |
|
<var>l</var> whose <code>nodeName</code> attribute value is equal to the |
1151 |
|
<code>nodeName</code> attribute value of <var>node</var>, if any.</p></li> |
1152 |
|
<li><p>If <var>r</var> is different from <code>null</code> and <var>r</var> |
1153 |
|
is same node as <var>node</var>, then abort these steps.</p></li> |
1154 |
|
<li><p>If <var>n</var> is <a href="#read-only">read$B!>(Bonly</a>, then raise a |
1155 |
|
<code>NO_MODIFICATION_ALLOWED_ERR</code> and abort these steps.</p></li> |
1156 |
|
<li><p>If the <code>ownerDocument</code> attribute value of <var>node</var> |
1157 |
|
is different from that of <var>n</var>, then raise a |
1158 |
|
<code>WRONG_DOCUMENT_ERR</code> and abort these steps.</p></li> |
1159 |
|
<li><p>If the value of the attribute <var>owner-attr</var> of <var>node</var> |
1160 |
|
is different from <code>null</code>, then raise a |
1161 |
|
<code>HIERARCHY_REQUEST_ERR</code> and abort these steps.</p></li> |
1162 |
|
<li><p>If <var>r</var> is a node, then remove it from <var>r</var>.</p> |
1163 |
|
|
1164 |
|
<div class="note memo"> |
1165 |
|
<p>By the removal of <var>r</var>, the attribute <var>owner-attr</var> of |
1166 |
|
<var>r</var> is set to <code>null</code>.</p> |
1167 |
|
</div></li> |
1168 |
|
<li><p>Add <var>node</var> to <var>l</var>.</p> |
1169 |
|
|
1170 |
|
<div class="note memo"> |
1171 |
|
<p>By the addition of <var>node</var>, the attribute <var>owner-attr</var> of |
1172 |
|
<var>node</var> is set to <var>n</var>.</p> |
1173 |
|
</div></li> |
1174 |
|
</ol> |
1175 |
|
|
1176 |
<div class=ed> |
<div class=ed> |
1177 |
<p>A future version of this interface might define the |
<p>A future version of this interface might define the |
1178 |
<code>parameterEntities</code> and getter/setter for parameter entities. |
<code>parameterEntities</code> and getter/setter for parameter entities. |
1211 |
cannot have any child node.</p> |
cannot have any child node.</p> |
1212 |
|
|
1213 |
<p>The <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> |
<p>The <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> |
1214 |
interface <em class=rfc2119>MUST</em> be implemented as following:</p> |
interface <em class=rfc2119>MUST</em> be implemented as the following |
1215 |
|
<a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p> |
1216 |
<pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> : <a href="#Node">Node</a> { |
<pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> : <a href="#Node">Node</a> { |
1217 |
readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>; |
readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>; |
1218 |
|
|
1220 |
<a href="#AttributeDefinition">AttributeDefinition</a> <a href="#getAttributeDefinitionNode">getAttributeDefinitionNode</a> |
<a href="#AttributeDefinition">AttributeDefinition</a> <a href="#getAttributeDefinitionNode">getAttributeDefinitionNode</a> |
1221 |
(in DOMString <a href="#getAttributeDefinitionNode-name"><var>name</var></a>); |
(in DOMString <a href="#getAttributeDefinitionNode-name"><var>name</var></a>); |
1222 |
void <a href="#setAttributeDefinitionNode">setAttributeDefinitionNode</a> |
void <a href="#setAttributeDefinitionNode">setAttributeDefinitionNode</a> |
1223 |
(in <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#setAttributeDefinitionNode-name"><var>node</var></a>) |
(in <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#setAttributeDefinitionNode-node"><var>node</var></a>) |
1224 |
raises (DOMException); |
raises (DOMException); |
1225 |
}</code></pre> |
}</code></pre> |
1226 |
|
|
1302 |
<em class=rfc2119>MUST</em> return <code>null</code>.</p></dd> |
<em class=rfc2119>MUST</em> return <code>null</code>.</p></dd> |
1303 |
<dt><dfn id=setAttributeDefinitionNode class=dom-method><code>setAttributeDefinitionNode</code></dfn>, |
<dt><dfn id=setAttributeDefinitionNode class=dom-method><code>setAttributeDefinitionNode</code></dfn>, |
1304 |
method</dt> |
method</dt> |
1305 |
<dd class=ed>@@</dd> |
<dd><p>Associate an |
1306 |
|
<a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node with |
1307 |
|
the |
1308 |
|
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> |
1309 |
|
node.</p> |
1310 |
|
|
1311 |
|
<p>The |
1312 |
|
<dfn id=setAttributeDefinitionNode-node class=dom-param><var>node</var></dfn> |
1313 |
|
parameter is the node to associate.</p> |
1314 |
|
|
1315 |
|
<p>When invoked, the method <em class=rfc2119>MUST</em> follow the rules |
1316 |
|
to <a href="#algorithm-attach-node">attach a node</a>, where |
1317 |
|
<a href="#attach-node-n"><var>n</var></a> is the |
1318 |
|
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> |
1319 |
|
node, <a href="#attach-node-l"><var>l</var></a> is the |
1320 |
|
<a href="#attributeDefinitions"><code>attributeDefinitions</code></a> |
1321 |
|
attribute value of the |
1322 |
|
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node, |
1323 |
|
<a href="#attach-node-node"><var>node</var></a> is the |
1324 |
|
<a href="#setAttributeDefinitionNode-node"><var>node</var></a>, and |
1325 |
|
<a href="#attach-node-owner-attr"><var>owner-attr</var></a> is the |
1326 |
|
<a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a> |
1327 |
|
attribute.</p></dd> |
1328 |
</dl> |
</dl> |
1329 |
|
|
1330 |
<div class=ed> |
<div class=ed> |
1362 |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p> |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p> |
1363 |
|
|
1364 |
<p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
<p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
1365 |
interface <em class=rfc2119>MUST</em> be implemented as following:</p> |
interface <em class=rfc2119>MUST</em> be implemented as the following |
1366 |
|
<a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p> |
1367 |
<pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> : <a href="#Node">Node</a> { |
<pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> : <a href="#Node">Node</a> { |
1368 |
<span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span> |
<span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span> |
1369 |
const unsigned short <a href="#NO_TYPE_ATTR">NO_TYPE_ATTR</a> = 0; |
const unsigned short <a href="#NO_TYPE_ATTR">NO_TYPE_ATTR</a> = 0; |
1406 |
<p>On getting, the attribute <em class=rfc2119>MUST</em> return an |
<p>On getting, the attribute <em class=rfc2119>MUST</em> return an |
1407 |
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node. |
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node. |
1408 |
It <em class=rfc2119>MUST</em> be such a node that whose |
It <em class=rfc2119>MUST</em> be such a node that whose |
1409 |
<a href="#attributeDefinitons"><code>attributeDefinitions</code></a> |
<a href="#attributeDefinitions"><code>attributeDefinitions</code></a> |
1410 |
attribute contains the <code>NamedNodeMap</code> object that contains |
attribute contains the <code>NamedNodeMap</code> object that contains |
1411 |
the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
1412 |
node. If there is no such an |
node. If there is no such an |
1542 |
<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> |
1543 |
be used.</p> |
be used.</p> |
1544 |
|
|
1545 |
<p>In Perl binding <span class=ed>[PERLBINDING]</span>, the |
<p>In Perl binding |
1546 |
|
<cite class="bibref normative">[<a href="#ref-DOMPERL">DOMPERL</a>]</cite>, the |
1547 |
<code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the |
<code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the |
1548 |
<a href="#DeclaredValueType"><code>DeclaredValueType</code></a> |
<a href="#DeclaredValueType"><code>DeclaredValueType</code></a> |
1549 |
definition group.</p> |
definition group.</p> |
1607 |
<p>The definition group |
<p>The definition group |
1608 |
<dfn id=DefaultValueType><code>DefaultValueType</code></dfn> |
<dfn id=DefaultValueType><code>DefaultValueType</code></dfn> |
1609 |
contains integers indicating the type of the default for the attribute. |
contains integers indicating the type of the default for the attribute. |
1610 |
The definition group contains the following constans:</p> |
The definition group contains the following constants:</p> |
1611 |
|
|
1612 |
<table> |
<table> |
1613 |
<thead> |
<thead> |
1658 |
<h3>Modifications to the <code id=Entity>Entity</code> Interface</h3> |
<h3>Modifications to the <code id=Entity>Entity</code> Interface</h3> |
1659 |
|
|
1660 |
<p>The implementation of the <a href="#Entity"><code>Entity</code></a> |
<p>The implementation of the <a href="#Entity"><code>Entity</code></a> |
1661 |
interface <em class=rfc2119>MUST</em> be modified as following:</p> |
interface <em class=rfc2119>MUST</em> be modified as the following |
1662 |
|
<a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p> |
1663 |
<pre class=idl><code>// Modifications to the Entity interface |
<pre class=idl><code>// Modifications to the Entity interface |
1664 |
attribute DOMString <a href="#publicId">publicId</a>; |
attribute DOMString <a href="#publicId">publicId</a>; |
1665 |
attribute DOMString <a href="#systemId">systemId</a>; |
attribute DOMString <a href="#systemId">systemId</a>; |
1759 |
<h3>Modifications to the <code id=Notation>Notation</code> Interface</h3> |
<h3>Modifications to the <code id=Notation>Notation</code> Interface</h3> |
1760 |
|
|
1761 |
<p>The implementation of the <a href="#Notation"><code>Notation</code></a> |
<p>The implementation of the <a href="#Notation"><code>Notation</code></a> |
1762 |
interface <em class=rfc2119>MUST</em> be modified as following:</p> |
interface <em class=rfc2119>MUST</em> be modified as the following |
1763 |
|
<a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p> |
1764 |
<pre class=idl><code>// Modifications to the Notation interface |
<pre class=idl><code>// Modifications to the Notation interface |
1765 |
attribute DOMString <a href="#publicId">publicId</a>; |
attribute DOMString <a href="#publicId">publicId</a>; |
1766 |
attribute DOMString <a href="#systemId">systemId</a>; |
attribute DOMString <a href="#systemId">systemId</a>; |
1786 |
April 2004</time>. <em>This</em> version of the specification is referenced. |
April 2004</time>. <em>This</em> version of the specification is referenced. |
1787 |
The latest version of the specification is available at |
The latest version of the specification is available at |
1788 |
<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> |
<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> |
1789 |
|
<dt id=ref-DOMBIND>DOMBIND</dt> |
1790 |
|
<dd><cite><a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/">Language |
1791 |
|
Bindings for <abbr>DOM</abbr> Specifications</a></cite>, <abbr>W3C</abbr> |
1792 |
|
Working Draft, <time datetime=2007-10-17>17 October 2007</time>. |
1793 |
|
<em>This</em> version of the specification is referenced. The latest version |
1794 |
|
of the specification is available at |
1795 |
|
<code class=uri><<a href="http://www.w3.org/TR/DOM-Bindings/">http://www.w3.org/TR/DOM-Bindings/</a>></code>.</dd> |
1796 |
|
<dt id=ref-DOMPERL>DOMPERL</dt> |
1797 |
|
<dd><cite><a href="http://suika.fam.cx/gate/2005/sw/manakai/DOM%20Perl%20Binding">manakai's |
1798 |
|
<abbr>DOM</abbr> Perl Binding</a></cite>, editor's draft. Work in |
1799 |
|
progress.</dd> |
1800 |
<dt id=ref-HTML5>HTML5</dt> |
<dt id=ref-HTML5>HTML5</dt> |
1801 |
<dd><cite><a href="http://whatwg.org/html5"><abbr>HTML</abbr> 5</a></cite>, |
<dd><cite><a href="http://whatwg.org/html5"><abbr>HTML</abbr> 5</a></cite>, |
1802 |
<abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr> |
<abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr> |
1816 |
14</a>, <abbr title="Request for Comments">RFC</abbr> 2119, |
14</a>, <abbr title="Request for Comments">RFC</abbr> 2119, |
1817 |
<time datetime=1997-03>March 1997</time>. |
<time datetime=1997-03>March 1997</time>. |
1818 |
<em>This</em> version of the specification is referenced.</dd> |
<em>This</em> version of the specification is referenced.</dd> |
1819 |
<dt id=ref-XML10">XML10</dt> |
<dt id=ref-MANAKAI>MANAKAI</dt> |
1820 |
|
<dd><cite><a href="http://suika.fam.cx/gate/2005/sw/manakai/DOM%20Extensions"> |
1821 |
|
manakai's <abbr>DOM</abbr> Extensions</a></cite>, editor's draft. Work in |
1822 |
|
progress.</dd> |
1823 |
|
<dt id=ref-XML10>XML10</dt> |
1824 |
<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 |
1825 |
Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>, |
Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>, |
1826 |
<abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August |
<abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August |
1833 |
Markup Language (<abbr>XML</abbr>) 1.1 (Second Edition)</a></cite>, |
Markup Language (<abbr>XML</abbr>) 1.1 (Second Edition)</a></cite>, |
1834 |
<abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August |
<abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August |
1835 |
2006</time>, edited in place <time datetime=2006-09-29>29 September |
2006</time>, edited in place <time datetime=2006-09-29>29 September |
1836 |
2006</time>. <em>This version of the specification is referenced. The |
2006</time>. <em>This</em> version of the specification is referenced. The |
1837 |
latest version of the specification is available at |
latest version of the specification is available at |
1838 |
<code class=uri><<a href="http://www.w3.org/TR/xml11">http://www.w3.org/TR/xml11</a>></code>.</dd> |
<code class=uri><<a href="http://www.w3.org/TR/xml11">http://www.w3.org/TR/xml11</a>></code>.</dd> |
1839 |
</dl> |
</dl> |