156 |
is defined in the <abbr>DOM</abbr> Level 3 Core specification |
is defined in the <abbr>DOM</abbr> Level 3 Core specification |
157 |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p> |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p> |
158 |
|
|
159 |
<p class=ed>@@ ref to DOM Binding Spec</p> |
<p>The <em id=idl-fragment><abbr>IDL</abbr> fragments</em> in this document are |
160 |
|
to be interpreted as described in the <cite>Language Bindings for |
161 |
|
<abbr>DOM</abbr> Specifications</cite> specification |
162 |
|
<cite class="bibref normative">[<a href="#ref-DOMBIND">DOMBIND</a>]</cite>.</p> |
163 |
|
|
164 |
|
<p>Some <abbr>IDL</abbr> fragments are presented as <i>patch</i> to an |
165 |
|
<abbr>IDL</abbr> fragment defined in another document. They are to be |
166 |
|
interpreted as an instance of |
167 |
|
<a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMembers"><code>InterfaceMembers</code></a> |
168 |
|
<cite class="bibref normative">[<a href="#ref-DOMBIND">DOMBIND</a>]</cite>. |
169 |
|
If the <abbr>IDL</abbr> fragment to which the <i>patch</i> is applied has any |
170 |
|
instance of |
171 |
|
<a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a> |
172 |
|
with same |
173 |
|
<a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#prod-identifier"><code>identifier</code></a> |
174 |
|
part as that of any instance of |
175 |
|
<a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a> |
176 |
|
in the <i>patch</i>, then the former instance of |
177 |
|
<a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a> |
178 |
|
<em class=rfc2119>MUST</em> be ignored.</p> |
179 |
</div> |
</div> |
180 |
|
|
181 |
<div class=section id=conformance-categories> |
<div class=section id=conformance-categories> |
193 |
all the features in this document, the implementation have to implement |
all the features in this document, the implementation have to implement |
194 |
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 |
195 |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>) |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>) |
196 |
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 |
197 |
Perl binding <span class=ed>[PERLBINDING]</span>).</dd> |
<cite class="bibref normative">[<a href="#ref-DOMBIND">DOMBIND</a>]</cite> |
198 |
|
or Perl binding |
199 |
|
<cite class="bibref normative">[<a href="#ref-DOMPERL">DOMPERL</a>]</cite>). |
200 |
|
A conforming implementation <em class=rfc2119>MUST</em> also be a |
201 |
|
<a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#dfn-conforming-implementation">conforming |
202 |
|
implementation</a> of the <abbr>IDL</abbr> fragments in this document, as |
203 |
|
described in the <cite>Language Bindings for <abbr>DOM</abbr> |
204 |
|
Specifications</cite> specification |
205 |
|
<cite class="bibref normative">[<a href="#ref-DOMBIND">DOMBIND</a>]</cite>.</dd> |
206 |
<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 |
207 |
to <abbr>DOM</abbr> tree converter)</dt> |
to <abbr>DOM</abbr> tree converter)</dt> |
208 |
<dd>A software component that converts |
<dd>A software component that converts |
275 |
|
|
276 |
<p>The implementation of the |
<p>The implementation of the |
277 |
<a href="#Node"><code>Node</code></a> interface |
<a href="#Node"><code>Node</code></a> interface |
278 |
<em class=rfc2119>MUST</em> be modified as following:</p> |
<em class=rfc2119>MUST</em> be modified as the following |
279 |
|
<a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p> |
280 |
<pre class=idl><code>// Additions to the Node interface |
<pre class=idl><code>// Additions to the Node interface |
281 |
|
|
282 |
// Additions to the NodeType definition group |
// Additions to the NodeType definition group |
297 |
<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> |
298 |
|
|
299 |
<dl> |
<dl> |
300 |
<dt><code id=attributes>attributes</code></dt> |
<dt><code id=attributes>attributes</code>, |
301 |
|
<code id=localName>localName</code>, |
302 |
|
<code id=manakaiLocalName>manakaiLocalName</code> |
303 |
|
<cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite>, |
304 |
|
<code id=namespaceURI>namespaceURI</code>, and |
305 |
|
<code id=prefix>prefix</code></dt> |
306 |
<dd> |
<dd> |
307 |
<p>On getting, the attribute <em class=rfc2119>MUST</em> return |
<p>On getting, the attributes <em class=rfc2119>MUST</em> return |
308 |
<code>null</code>.</p> |
<code>null</code>.</p> |
309 |
</dd> |
</dd> |
310 |
<dt><code id=baseURI>baseURI</code></dt> |
<dt><code id=baseURI>baseURI</code></dt> |
414 |
</dd> |
</dd> |
415 |
<dt><code id=nodeType>nodeType</code></dt> |
<dt><code id=nodeType>nodeType</code></dt> |
416 |
<dd> |
<dd> |
417 |
<p>On getting, the attribute <em class=rfc2119>MUST</em> return |
<p>On getting, the attribute <!--<em class=rfc2119>MUST</em>--> returns |
418 |
|
<!-- NOTE: No MUST, to avoid circular reference (nodeType==8100[12] |
419 |
|
is defined that they MUST implement ElementType|AttributeDefinition). --> |
420 |
<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> |
421 |
(if the node is an |
(if the node is an |
422 |
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) or |
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) or |
526 |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p> |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p> |
527 |
|
|
528 |
<p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface |
<p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface |
529 |
<em class=rfc2119>MUST</em> be implemented as following:</p> |
<em class=rfc2119>MUST</em> be implemented as the following |
530 |
|
<a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p> |
531 |
<pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> { |
<pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> { |
532 |
DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a> |
DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a> |
533 |
(in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>) |
(in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>) |
572 |
<a href="#publicId"><code>publicId</code></a>, and |
<a href="#publicId"><code>publicId</code></a>, and |
573 |
<a href="#systemId"><code>systemId</code></a></dt> |
<a href="#systemId"><code>systemId</code></a></dt> |
574 |
<dd>Empty strings.</dd> |
<dd>Empty strings.</dd> |
|
<dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt> |
|
|
<dd><code>false</code>.</dd> |
|
575 |
<dt><code>nodeName</code></dt> |
<dt><code>nodeName</code></dt> |
576 |
<dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd> |
<dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd> |
577 |
<dt><code>ownerDocument</code></dt> |
<dt><code>ownerDocument</code></dt> |
578 |
<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 |
579 |
method is invoked.</dd> |
method is invoked.</dd> |
580 |
</dl> |
</dl> |
581 |
|
<p>The returned node <em class=rfc2119>MUST NOT</em> be marked as |
582 |
|
<a href="#read-only">read$B!>(Bonly</a>.</p> |
583 |
<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 |
584 |
containing five general entity declarations: <code>amp</code>, |
containing five general entity declarations: <code>amp</code>, |
585 |
<code>lt</code>, <code>gt</code>, <code>quot</code>, and |
<code>lt</code>, <code>gt</code>, <code>quot</code>, and |
601 |
<dl> |
<dl> |
602 |
<dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt> |
<dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt> |
603 |
<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> |
|
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> |
|
<dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt> |
|
|
<dd><code>false</code>.</dd> |
|
606 |
<dt><a href="#nodeName"><code>nodeName</code></a></dt> |
<dt><a href="#nodeName"><code>nodeName</code></a></dt> |
607 |
<dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd> |
<dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd> |
608 |
<dt><code>ownerDocument</code></dt> |
<dt><code>ownerDocument</code></dt> |
609 |
<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> |
610 |
<dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a></dt> |
<dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a> |
611 |
|
and <code>parentNode</code></dt> |
612 |
<dd><code>null</code>.</dd> |
<dd><code>null</code>.</dd> |
|
<dt class=ed>@@ Ensure all attributes are defined</dt> |
|
613 |
</dl> |
</dl> |
614 |
|
<p>The returned node <em class=rfc2119>MUST NOT</em> be marked as |
615 |
|
<a href="#read-only">read$B!>(Bonly</a>.</p> |
616 |
</dd> |
</dd> |
617 |
<dt><dfn id=createAttributeDefinition class=dom-method><code>createAttributeDefinition</code></dfn>, |
<dt><dfn id=createAttributeDefinition class=dom-method><code>createAttributeDefinition</code></dfn>, |
618 |
method</dt> |
method</dt> |
630 |
<dl> |
<dl> |
631 |
<dt><a href="#allowedTokens"><code>allowedTokens</code></a></dt> |
<dt><a href="#allowedTokens"><code>allowedTokens</code></a></dt> |
632 |
<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> |
|
633 |
<dt><code>childNodes</code></dt> |
<dt><code>childNodes</code></dt> |
634 |
<dd>An empty <code>NodeList</code> object.</dd> |
<dd>An empty <code>NodeList</code> object.</dd> |
635 |
<dt><a href="#declaredType"><code>declaredType</code></a></dt> |
<dt><a href="#declaredType"><code>declaredType</code></a></dt> |
636 |
<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> |
637 |
<dt><a href="#defaultType"><code>defaultType</code></a></dt> |
<dt><a href="#defaultType"><code>defaultType</code></a></dt> |
638 |
<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> |
|
639 |
<dt><a href="#nodeName"><code>nodeName</code></a></dt> |
<dt><a href="#nodeName"><code>nodeName</code></a></dt> |
640 |
<dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd> |
<dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd> |
641 |
<dt><code>ownerDocument</code></dt> |
<dt><code>ownerDocument</code></dt> |
642 |
<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> |
643 |
<dt class=ed>@@ Ensure all attributes are defined</dt> |
<dt><a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a> |
644 |
|
and <code>parentNode</code></dt> |
645 |
|
<dd><code>null</code>.</dd> |
646 |
</dl> |
</dl> |
647 |
|
<p>The returned node <em class=rfc2119>MUST NOT</em> be marked as |
648 |
|
<a href="#read-only">read$B!>(Bonly</a>.</p> |
649 |
|
|
650 |
<!-- This requirement, if not droped, should be part of xml-id spec. |
<!-- This requirement, if not droped, should be part of xml-id spec. |
651 |
<div class=ed> |
<div class=ed> |
670 |
an <a href="#Entity"><code>Entity</code></a> node with the following |
an <a href="#Entity"><code>Entity</code></a> node with the following |
671 |
attributes:</p> |
attributes:</p> |
672 |
<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> |
|
673 |
<dt><code>childNodes</code></dt> |
<dt><code>childNodes</code></dt> |
674 |
<dd>An empty <code>NodeList</code> object.</dd> |
<dd>An empty <code>NodeList</code> object.</dd> |
675 |
<dt><code>manakaiDeclarationBaseURI</code>, |
<dt><code>manakaiDeclarationBaseURI</code>, |
676 |
<code>manakaiEntityBaseURI</code>, and |
<code>manakaiEntityBaseURI</code>, and <code>manakaiEntityURI</code> |
677 |
<code>manakaiEntityURI</code> <span class=ed>@@ ref</span></dt> |
<cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt> |
678 |
<dd>No explicit value is set.</dd> |
<dd>No explicit value is set.</dd> |
679 |
<dt><a href="#hasReplacementTree"><code>hasReplacementTree</code></a> and |
<dt><a href="#hasReplacementTree"><code>hasReplacementTree</code></a></dt> |
|
<code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt> |
|
680 |
<dd><code>false</code>.</dd> |
<dd><code>false</code>.</dd> |
681 |
<dt><code>nodeName</code></dt> |
<dt><code>nodeName</code></dt> |
682 |
<dd><a href="#createGeneralEntity-name"><var>name</var></a>.</dd> |
<dd><a href="#createGeneralEntity-name"><var>name</var></a>.</dd> |
692 |
with its <code>nodeName</code> attribute set to <code>amp</code>.</p> |
with its <code>nodeName</code> attribute set to <code>amp</code>.</p> |
693 |
</div> |
</div> |
694 |
</dd> |
</dd> |
695 |
|
<dt><a href="#notationName"><code>notationName</code></a>, |
696 |
|
<a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>, |
697 |
|
and <code>parentNode</code></dt> |
698 |
|
<dd><code>null</code>.</dd> |
699 |
<dt><code>ownerDocument</code></dt> |
<dt><code>ownerDocument</code></dt> |
700 |
<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> |
701 |
<dt><a href="#publicId"><code>publicId</code></a> and |
<dt><a href="#publicId"><code>publicId</code></a> and |
702 |
<a href="#systemId"><code>systemId</code></a></dt> |
<a href="#systemId"><code>systemId</code></a></dt> |
703 |
<dd><code>null</code>.</dd> |
<dd><code>null</code>.</dd> |
704 |
<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> |
|
705 |
</dl> |
</dl> |
706 |
</dd> |
<p>The returned node <em class=rfc2119>MUST NOT</em> be marked as |
707 |
|
<a href="#read-only">read$B!>(Bonly</a>.</p></dd> |
708 |
<dt><dfn id=createNotation class=dom-method><code>createNotation</code></dfn>, |
<dt><dfn id=createNotation class=dom-method><code>createNotation</code></dfn>, |
709 |
method</dt> |
method</dt> |
710 |
<dd> |
<dd> |
716 |
<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 |
717 |
a <code>Notation</code> node with the following attributes:</p> |
a <code>Notation</code> node with the following attributes:</p> |
718 |
<dl> |
<dl> |
|
<dt><code>attributes</code>, |
|
|
<a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>, |
|
|
and <code>parentNode</code></dt> |
|
|
<dd><code>null</code>.</dd> |
|
719 |
<dt><code>childNodes</code></dt> |
<dt><code>childNodes</code></dt> |
720 |
<dd>An empty <code>NodeList</code> object.</dd> |
<dd>An empty <code>NodeList</code> object.</dd> |
721 |
<dt><code>manakaiDeclarationBaseURI</code></dt> |
<dt><code>manakaiDeclarationBaseURI</code> |
722 |
|
<cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt> |
723 |
<dd>No explicit value is set.</dd> |
<dd>No explicit value is set.</dd> |
|
<dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt> |
|
|
<dd><code>false</code>.</dd> |
|
724 |
<dt><code>nodeName</code></dt> |
<dt><code>nodeName</code></dt> |
725 |
<dd><a href="#createNotation-name"><var>name</var></a>.</dd> |
<dd><a href="#createNotation-name"><var>name</var></a>.</dd> |
726 |
<dt><code>ownerDocument</code></dt> |
<dt><code>ownerDocument</code></dt> |
727 |
<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> |
728 |
|
<dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a> |
729 |
|
and <code>parentNode</code></dt> |
730 |
|
<dd><code>null</code>.</dd> |
731 |
<dt><a href="#publicId"><code>publicId</code></a> and |
<dt><a href="#publicId"><code>publicId</code></a> and |
732 |
<a href="#systemId"><code>systemId</code></a></dt> |
<a href="#systemId"><code>systemId</code></a></dt> |
733 |
<dd><code>null</code>.</dd> |
<dd><code>null</code>.</dd> |
734 |
<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> |
|
735 |
</dl> |
</dl> |
736 |
</dd> |
<p>The returned node <em class=rfc2119>MUST NOT</em> be marked as |
737 |
|
<a href="#read-only">read$B!>(Bonly</a>.</p></dd> |
738 |
</dl> |
</dl> |
739 |
|
|
740 |
<p>These methods <em class=rfc2119>MUST</em> raise an |
<p>These methods <em class=rfc2119>MUST</em> raise an |
764 |
|
|
765 |
<p>A <a href="#DocumentType"><code>DocumentType</code></a> interface |
<p>A <a href="#DocumentType"><code>DocumentType</code></a> interface |
766 |
<em class=rfc2119>MAY</em> contain zero or more |
<em class=rfc2119>MAY</em> contain zero or more |
767 |
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> |
<code>ProcessingInstruction</code> nodes in the <code>NodeList</code> object |
768 |
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 |
|
769 |
<a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
<a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
770 |
|
|
771 |
<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 |
772 |
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> |
773 |
document, the <code>NodeList</code> object in the <code>childNodes</code> |
document, the <code>NodeList</code> object in the <code>childNodes</code> |
774 |
object <em class=rfc2119>MUST</em> contains the |
object <em class=rfc2119>MUST</em> contains the |
775 |
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> |
<code>ProcessingInstruction</code> nodes representing the processing |
776 |
nodes representing the processing instructions in the document type |
instructions in the document type definition of the document processed |
|
definition of the document processed |
|
777 |
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
<cite class="bibref normative">[<a href="#ref-XML10">XML10</a>, |
778 |
<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 |
779 |
the <a href="#DocumentType"><code>DocumentType</code></a> node is marked as |
the <a href="#DocumentType"><code>DocumentType</code></a> node is marked as |
788 |
<cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>, |
<cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>, |
789 |
the <code>NodeList</code> object in the <code>childNodes</code> attribute |
the <code>NodeList</code> object in the <code>childNodes</code> attribute |
790 |
of the node <em class=rfc2119>MUST</em> contain the |
of the node <em class=rfc2119>MUST</em> contain the |
791 |
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes |
<code>ProcessingInstruction</code> nodes created from any |
792 |
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 |
793 |
[children] property of the document type declaration item in the same |
instruction information items</a> in the list in the [children] property of the |
794 |
order.</p> |
<a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.doctype">document |
795 |
|
type declaration item</a> in the same order.</p> |
796 |
|
|
797 |
<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 |
798 |
a document type declaration information item, the list in the [children] |
a document type declaration information item, the list in the [children] |
799 |
property <em class=rfc2119>MUST</em> contain the processng instruction |
property <em class=rfc2119>MUST</em> contain the processng instruction |
800 |
information items created from the |
information items created from the <code>ProcessingInstruction</code> nodes |
|
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes |
|
801 |
in the <code>NodeList</code> object in the <code>childNodes</code> attribute |
in the <code>NodeList</code> object in the <code>childNodes</code> attribute |
802 |
of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
803 |
|
|
804 |
<p>The implementation of the |
<p>The implementation of the |
805 |
<a href="#DocumentType"><code>DocumentType</code></a> interface |
<a href="#DocumentType"><code>DocumentType</code></a> interface |
806 |
<em class=rfc2119>MUST</em> be modified as following:</p> |
<em class=rfc2119>MUST</em> be modified as the following |
807 |
|
<a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p> |
808 |
<pre class=idl><code>// Modifications to the DocumentType interface |
<pre class=idl><code>// Modifications to the DocumentType interface |
809 |
attribute DOMString <a href="#publicId">publicId</a>; |
attribute DOMString <a href="#publicId">publicId</a>; |
810 |
attribute DOMString <a href="#systemId">systemId</a>; |
attribute DOMString <a href="#systemId">systemId</a>; |
884 |
|
|
885 |
<p>The |
<p>The |
886 |
<a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a> |
<a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a> |
887 |
interface <em class=rfc2119>MUST</em> be implemented as following:</p> |
interface <em class=rfc2119>MUST</em> be implemented as the following |
888 |
|
<a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p> |
889 |
<pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> { |
<pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> { |
890 |
readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>; |
readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>; |
891 |
readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>; |
readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>; |
946 |
<a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
<a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
947 |
|
|
948 |
<p>On getting, the attribute <em class=rfc2119>MUST</em> return the |
<p>On getting, the attribute <em class=rfc2119>MUST</em> return the |
949 |
same value as the <code>entities</code> attribute (defined in the |
same value as the <code id=entities>entities</code> attribute (defined in the |
950 |
<a href="#DocumentType"><code>DocumentType</code></a> interface) of the same |
<a href="#DocumentType"><code>DocumentType</code></a> interface) of the same |
951 |
node.</p> |
node.</p> |
952 |
|
|
1036 |
<a href="#elementTypes"><code>elementTypes</code></a> attribute of the |
<a href="#elementTypes"><code>elementTypes</code></a> attribute of the |
1037 |
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 |
1038 |
<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> |
|
1039 |
<dt><dfn id=getGeneralEntityNode class=dom-method><code>getGeneralEntityNode</code></dfn>, |
<dt><dfn id=getGeneralEntityNode class=dom-method><code>getGeneralEntityNode</code></dfn>, |
1040 |
method</dt> |
method</dt> |
1041 |
<dd><p>Returns the <a href="#Entity"><code>Entity</code></a> node |
<dd><p>Returns the <a href="#Entity"><code>Entity</code></a> node |
1042 |
with the specified name.</p> |
with the specified name.</p> |
1043 |
|
|
1044 |
<p>The <dfn id=getEntityNode-name class=dom-param><var>name</var></dfn> |
<p>The |
1045 |
|
<dfn id=getGeneralEntityNode-name class=dom-param><var>name</var></dfn> |
1046 |
parameter is the name of the general entity.</p> |
parameter is the name of the general entity.</p> |
1047 |
|
|
1048 |
<p>When invoked, the method <em class=rfc2119>MUST</em> return the |
<p>When invoked, the method <em class=rfc2119>MUST</em> return the |
1049 |
<a href="#Entity"><code>Entity</code></a> node, |
<a href="#Entity"><code>Entity</code></a> node, |
1050 |
whose <a href="#nodeName"><code>nodeName</code></a> is equal to |
whose <a href="#nodeName"><code>nodeName</code></a> is equal to |
1051 |
<a href="#getEntityNode-name"><var>name</var></a>, in the |
<a href="#getGeneralEntityNode-name"><var>name</var></a>, in the |
1052 |
<code>NamedNodeMap</code> object in the |
<code>NamedNodeMap</code> object in the |
1053 |
<a href="#entities"><code>entities</code></a> attribute of the |
<a href="#entities"><code>entities</code></a> attribute of the |
1054 |
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 |
1119 |
cannot have any child node.</p> |
cannot have any child node.</p> |
1120 |
|
|
1121 |
<p>The <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> |
<p>The <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> |
1122 |
interface <em class=rfc2119>MUST</em> be implemented as following:</p> |
interface <em class=rfc2119>MUST</em> be implemented as the following |
1123 |
|
<a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p> |
1124 |
<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> { |
1125 |
readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>; |
readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>; |
1126 |
|
|
1128 |
<a href="#AttributeDefinition">AttributeDefinition</a> <a href="#getAttributeDefinitionNode">getAttributeDefinitionNode</a> |
<a href="#AttributeDefinition">AttributeDefinition</a> <a href="#getAttributeDefinitionNode">getAttributeDefinitionNode</a> |
1129 |
(in DOMString <a href="#getAttributeDefinitionNode-name"><var>name</var></a>); |
(in DOMString <a href="#getAttributeDefinitionNode-name"><var>name</var></a>); |
1130 |
void <a href="#setAttributeDefinitionNode">setAttributeDefinitionNode</a> |
void <a href="#setAttributeDefinitionNode">setAttributeDefinitionNode</a> |
1131 |
(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>) |
1132 |
raises (DOMException); |
raises (DOMException); |
1133 |
}</code></pre> |
}</code></pre> |
1134 |
|
|
1248 |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p> |
<cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p> |
1249 |
|
|
1250 |
<p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
<p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
1251 |
interface <em class=rfc2119>MUST</em> be implemented as following:</p> |
interface <em class=rfc2119>MUST</em> be implemented as the following |
1252 |
|
<a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p> |
1253 |
<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> { |
1254 |
<span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span> |
<span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span> |
1255 |
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; |
1292 |
<p>On getting, the attribute <em class=rfc2119>MUST</em> return an |
<p>On getting, the attribute <em class=rfc2119>MUST</em> return an |
1293 |
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node. |
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node. |
1294 |
It <em class=rfc2119>MUST</em> be such a node that whose |
It <em class=rfc2119>MUST</em> be such a node that whose |
1295 |
<a href="#attributeDefinitons"><code>attributeDefinitions</code></a> |
<a href="#attributeDefinitions"><code>attributeDefinitions</code></a> |
1296 |
attribute contains the <code>NamedNodeMap</code> object that contains |
attribute contains the <code>NamedNodeMap</code> object that contains |
1297 |
the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
1298 |
node. If there is no such an |
node. If there is no such an |
1428 |
<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> |
1429 |
be used.</p> |
be used.</p> |
1430 |
|
|
1431 |
<p>In Perl binding <span class=ed>[PERLBINDING]</span>, the |
<p>In Perl binding |
1432 |
|
<cite class="bibref normative">[<a href="#ref-DOMPERL">DOMPERL</a>]</cite>, the |
1433 |
<code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the |
<code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the |
1434 |
<a href="#DeclaredValueType"><code>DeclaredValueType</code></a> |
<a href="#DeclaredValueType"><code>DeclaredValueType</code></a> |
1435 |
definition group.</p> |
definition group.</p> |
1544 |
<h3>Modifications to the <code id=Entity>Entity</code> Interface</h3> |
<h3>Modifications to the <code id=Entity>Entity</code> Interface</h3> |
1545 |
|
|
1546 |
<p>The implementation of the <a href="#Entity"><code>Entity</code></a> |
<p>The implementation of the <a href="#Entity"><code>Entity</code></a> |
1547 |
interface <em class=rfc2119>MUST</em> be modified as following:</p> |
interface <em class=rfc2119>MUST</em> be modified as the following |
1548 |
|
<a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p> |
1549 |
<pre class=idl><code>// Modifications to the Entity interface |
<pre class=idl><code>// Modifications to the Entity interface |
1550 |
attribute DOMString <a href="#publicId">publicId</a>; |
attribute DOMString <a href="#publicId">publicId</a>; |
1551 |
attribute DOMString <a href="#systemId">systemId</a>; |
attribute DOMString <a href="#systemId">systemId</a>; |
1645 |
<h3>Modifications to the <code id=Notation>Notation</code> Interface</h3> |
<h3>Modifications to the <code id=Notation>Notation</code> Interface</h3> |
1646 |
|
|
1647 |
<p>The implementation of the <a href="#Notation"><code>Notation</code></a> |
<p>The implementation of the <a href="#Notation"><code>Notation</code></a> |
1648 |
interface <em class=rfc2119>MUST</em> be modified as following:</p> |
interface <em class=rfc2119>MUST</em> be modified as the following |
1649 |
|
<a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p> |
1650 |
<pre class=idl><code>// Modifications to the Notation interface |
<pre class=idl><code>// Modifications to the Notation interface |
1651 |
attribute DOMString <a href="#publicId">publicId</a>; |
attribute DOMString <a href="#publicId">publicId</a>; |
1652 |
attribute DOMString <a href="#systemId">systemId</a>; |
attribute DOMString <a href="#systemId">systemId</a>; |
1672 |
April 2004</time>. <em>This</em> version of the specification is referenced. |
April 2004</time>. <em>This</em> version of the specification is referenced. |
1673 |
The latest version of the specification is available at |
The latest version of the specification is available at |
1674 |
<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> |
1675 |
|
<dt id=ref-DOMBIND>DOMBIND</dt> |
1676 |
|
<dd><cite><a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/">Language |
1677 |
|
Bindings for <abbr>DOM</abbr> Specifications</a></cite>, <abbr>W3C</abbr> |
1678 |
|
Working Draft, <time datetime=2007-10-17>17 October 2007</time>. |
1679 |
|
<em>This</em> version of the specification is referenced. The latest version |
1680 |
|
of the specification is available at |
1681 |
|
<code class=uri><<a href="http://www.w3.org/TR/DOM-Bindings/">http://www.w3.org/TR/DOM-Bindings/</a>></code>.</dd> |
1682 |
|
<dt id=ref-DOMPERL>DOMPERL</dt> |
1683 |
|
<dd><cite><a href="http://suika.fam.cx/gate/2005/sw/manakai/DOM%20Perl%20Binding">manakai's |
1684 |
|
<abbr>DOM</abbr> Perl Binding</a></cite>, editor's draft. Work in |
1685 |
|
progress.</dd> |
1686 |
<dt id=ref-HTML5>HTML5</dt> |
<dt id=ref-HTML5>HTML5</dt> |
1687 |
<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>, |
1688 |
<abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr> |
<abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr> |
1702 |
14</a>, <abbr title="Request for Comments">RFC</abbr> 2119, |
14</a>, <abbr title="Request for Comments">RFC</abbr> 2119, |
1703 |
<time datetime=1997-03>March 1997</time>. |
<time datetime=1997-03>March 1997</time>. |
1704 |
<em>This</em> version of the specification is referenced.</dd> |
<em>This</em> version of the specification is referenced.</dd> |
1705 |
<dt id=ref-XML10">XML10</dt> |
<dt id=ref-MANAKAI>MANAKAI</dt> |
1706 |
|
<dd><cite><a href="http://suika.fam.cx/gate/2005/sw/manakai/DOM%20Extensions"> |
1707 |
|
manakai's <abbr>DOM</abbr> Extensions</a></cite>, editor's draft. Work in |
1708 |
|
progress.</dd> |
1709 |
|
<dt id=ref-XML10>XML10</dt> |
1710 |
<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 |
1711 |
Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>, |
Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>, |
1712 |
<abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August |
<abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August |
1719 |
Markup Language (<abbr>XML</abbr>) 1.1 (Second Edition)</a></cite>, |
Markup Language (<abbr>XML</abbr>) 1.1 (Second Edition)</a></cite>, |
1720 |
<abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August |
<abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August |
1721 |
2006</time>, edited in place <time datetime=2006-09-29>29 September |
2006</time>, edited in place <time datetime=2006-09-29>29 September |
1722 |
2006</time>. <em>This version of the specification is referenced. The |
2006</time>. <em>This</em> version of the specification is referenced. The |
1723 |
latest version of the specification is available at |
latest version of the specification is available at |
1724 |
<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> |
1725 |
</dl> |
</dl> |