/[suikacvs]/markup/xml/domdtdef/domdtdef-work.en.html
Suika

Diff of /markup/xml/domdtdef/domdtdef-work.en.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.16 by wakaba, Tue Dec 4 10:44:09 2007 UTC revision 1.20 by wakaba, Wed Dec 5 10:26:35 2007 UTC
# Line 10  Line 10 
10    
11  <div class="header">  <div class="header">
12  <h1>DOM Document Type Definition Module</h1>  <h1>DOM Document Type Definition Module</h1>
13  <h2>Working Draft <time datetime=2007-12-03>3 December 2007</time></h2>  <h2>Working Draft <time datetime=2007-12-05>5 December 2007</time></h2>
14    
15  <dl class="versions-uri">  <dl class="versions-uri">
16  <dt>This Version</dt>  <dt>This Version</dt>
# Line 129  interface.</p> Line 129  interface.</p>
129  <p>If the <code>strictErrorChecking</code> attribute of the  <p>If the <code>strictErrorChecking</code> attribute of the
130  <code>Document</code> node is <code>false</code>, the methods are  <code>Document</code> node is <code>false</code>, the methods are
131  not required to raise exceptions <span class=ed>[DOM3]</span>.</p>  not required to raise exceptions <span class=ed>[DOM3]</span>.</p>
132    
133    <div class=ed>
134    <p>Conformant product classes: implementation, XML parser (XML document ->
135    DOM converter), XML serializer (DOM -> XML document covnerter).
136    XML Infoset -> DOM converter, and DOM -> XML Infoset converter.</p>
137    </div>
138  </div>  </div>
139    
140  <div class=section id=dom-dtdef>  <div class=section id=dom-dtdef>
141  <h2><abbr>DOM</abbr> Document Type Definition Module</h2>  <h2><abbr>DOM</abbr> Document Type Definition Module</h2>
142    
143  <p>The <abbr>DOM</abbr> Document Type Definition module, version 3.0,  <p>The <abbr>DOM</abbr> Document Type Definition module, version 3.0,
144  consists of three interfaces:</p>  introduces four interfaces:
145  <ul>  <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a>,
146  <li><a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a></li>  <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>,
147  <li><a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a></li>  <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
148  <li><a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a></li>  and <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>.
149  <li><a href="#AttributeDefinition"><code>AttributeDefinition</code></a></li>  In addition, it modifies existing interfaces
 </ul>  
   
 <p>In addition, it modifies interfaces  
150  <a href="#Node"><code>Node</code></a>,  <a href="#Node"><code>Node</code></a>,
151    <a href="#Document"><code>Document</code></a>,
152  <a href="#DocumentType"><code>DocumentType</code></a>,  <a href="#DocumentType"><code>DocumentType</code></a>,
153  <a href="#Entity"><code>Entity</code></a>,  <a href="#Entity"><code>Entity</code></a>, and
154  <a href="#EntityReference"><code>EntityReference</code></a>,  <a href="#Notation"><code>Notation</code></a>.</p>
 <a href="#Notation"><code>Notation</code></a>, and  
 <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>.</p>  
155    
156  <div class=section id=features>  <div class=section id=features>
157  <h3>Feature Name</h3>  <h3>Feature Name</h3>
# Line 158  consists of three interfaces:</p> Line 160  consists of three interfaces:</p>
160  the <abbr>DOM</abbr> Document Type Definition module, the  the <abbr>DOM</abbr> Document Type Definition module, the
161  <code>hasFeature</code> method of a <code>DOMImplementation</code> object  <code>hasFeature</code> method of a <code>DOMImplementation</code> object
162  <em class=rfc2119>MUST</em> return <code>true</code> when the parameters are  <em class=rfc2119>MUST</em> return <code>true</code> when the parameters are
163  set to <code>http://suika.fam.cx/www/2006/feature/XDoctype</code> and  set to
164  <code>3.0</code> respectively.</p>  <dfn id=feature-XDoctype><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></dfn>
165    and <dfn id=feature-XDoctype-3.0><code>3.0</code></dfn> respectively.</p>
166    
167  <p>In such an implementation, the <code>getFeature</code> method of a  <p>In such an implementation, the <code>getFeature</code> method of a
168  <code>Document</code> object <em class=rfc2119>MUST</em> return the (at least  <code>Document</code> object <em class=rfc2119>MUST</em> return the (at least
169  conceptually) same object implementing the  conceptually) same object implementing the
170  <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface when  <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface when
171  the parameters are set to  the parameters are set to
172  <code>http://suika.fam.cx/www/2006/feature/XDoctype</code> and  <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
173  <code>3.0</code> respectively.  Likewise, any method that takes one or more  and <a href="#feature-XDoctype-3.0"><code>3.0</code></a> respectively.  
174  feature names with or without version number, including the methods  Likewise, any method that takes one or more feature names with or without
175  <code>hasFeature</code> and <code>getFeature</code>,  version number, including the methods <code>hasFeature</code> and
176  <em class=rfc2119>MUST</em> behave in a manner consistent with the  <code>getFeature</code>, <em class=rfc2119>MUST</em> behave in a manner
177  aforementioned cases.</p>  consistent with the aforementioned cases.</p>
178  </div>  </div>
179    
180  <div class=section id=section-node>  <div class=section id=section-node>
# Line 212  these kinds of nodes, methods and attrib Line 215  these kinds of nodes, methods and attrib
215      of the node in the <code>ownerDocument</code> attribute of the node.      of the node in the <code>ownerDocument</code> attribute of the node.
216      Note that the value might be <code>null</code>.</p>      Note that the value might be <code>null</code>.</p>
217    </dd>    </dd>
218    <dt><code id=cloneNode>cloneNode</code></dt>
219      <dd class=ed>@@</dd>
220      <dd class=ed>@@ If Attr and AttributeDefinition is inconsistent, then ...</dd>
221    <dt><code id=compareDocumentPosition>compareDocumentPosition</code></dt>
222      <dd class=ed>@@</dd>
223    <dt><code id=isDefaultNamespace>isDefaultNamespace</code></dt>
224      <dd><p>When invoked, the method <em class=rfc2119>MUST</em> return
225      <code>false</code>.</p></dd>
226    <dt><code id=isEqualNode>isEqualNode</code></dt>
227      <dd><p>For the <a href="#isEqualNode"><code>isEqualNode</code></a> method,
228      following items are added to the list of conditions for equality:</p>
229    
230      <ul>
231      <li>
232        <p>If the nodes are <a href="#DocumentType"><code>DocumentType</code></a>
233        and at least one of them has the support for the feature
234        <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>:</p>
235        <ul>
236        <li>they are equal according to <abbr>DOM</abbr> level 3 definition
237        <span class=ed>@@ ref</span>, and
238        <li>either:
239          <ul><!--
240          <li>both of them does not support the feature
241          <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>,</li>-->
242          <li>exactly one of them support the feature
243          <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
244          and the <code>length</code> attribute of the <code>NamedNodeMap</code>
245          object in the <a href="#elementTypes"><code>elementTypes</code></a>
246          attribute of it is equal to <code>0</code>, or</li>
247          <li>both of them support the feature
248          <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
249          and the values of the
250          <a href="#elementTypes"><code>elementTypes</code></a> attributes are
251          equal (equality of the
252          <a href="#elementTypes"><code>elementTypes</code></a> attribute is same
253          as that for the <code>attributes</code> attribute).</li>
254          </ul>
255        </li>
256        </ul>
257      </li>
258    
259      <li><p>If the nodes are
260      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
261      the values of the
262      <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
263      attributes are equal (equality of the
264      <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
265      attribute is same as that for the <code>attributes</code> attribute).</p></li>
266    
267      <li><p>If the nodes are
268      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>,
269      the values of the <a href="#declaredType"><code>declaredType</code></a> and
270      the <a href="#defaultType"><code>defaultType</code></a> attributes are
271      equal respectively.</p></li>
272    
273      <li><p>If the nodes are
274      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>,
275      the values of the <code>DOMStringList</code> objects in the
276      <a href="#allowedTokens"><code>allowedTokens</code></a> attributes
277      are equal, i.e. their <code>length</code> attribute values are equal and
278      each string exists in a list is contained in another list (their indeces
279      may be different), with an additional constraint that the number of the
280      items that are equal to a string in a list is equal to the number
281      of the items equal to the string in another list.</p></li>
282      </ul></dd>
283    <dt><code id=lookupNamespaceURI>lookupNamespaceURI</code> and
284    <code id=lookupPrefix>lookupPrefix</code></dt>
285      <dd><p>When invoked, the methods <em class=rfc2119>MUST</em> return
286      <code>null</code>.</p></dd>
287  <dt><code id=nodeName>nodeName</code></dt>  <dt><code id=nodeName>nodeName</code></dt>
288    <dd>    <dd>
289      <p>If the node is an      <p>If the node is an
# Line 302  whose [CODE(DOMa)@en[[[data]]]] is the n Line 374  whose [CODE(DOMa)@en[[[data]]]] is the n
374  and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].  and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].
375  </pre>  </pre>
376    </dd>    </dd>
377    <dt><code id=normalize>normalize</code></dt>
378      <dd><p>When a <a href="#DocumentType"><code>DocumentType</code></a> is
379      normalized, any nodes in the <code>NamedNodeMap</code> object in the
380      <a href="#elementTypes"><code>elementTypes</code></a> attribute
381      <em class=rfc2119>MUST</em> be normalized as well.</p>
382    
383      <p>When an
384      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
385      is normalized, any nodes in the <code>NamedNodeMap</code> object in the
386      <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
387      attribute <em class=rfc2119>MUST</em> be normalized as well.</p></dd>
388  <dt class=ed>@@ ...</dt>  <dt class=ed>@@ ...</dt>
389  </dl>  </dl>
390    
391  </div>  </div>
392    
393    <div class=section id=section-document>
394    <h3>Modifications to the <code id=Document>Document</code> Interface</h3>
395    
396    <p>If an attempt is made to adopt an
397    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> or
398    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node,
399    the <code id=adoptNode>adoptNode</code> method <em class=rfc2119>MUST</em>
400    raise a <code>NOT_SUPPORTED_ERR</code> exception <span class=ed>@@
401    ref</span>.</p>
402    </div>
403    
404  <div class=section id=section-documentxdoctype>  <div class=section id=section-documentxdoctype>
405  <h3>The <code>DocumentXDoctype</code> Interface</h3>  <h3>The <code>DocumentXDoctype</code> Interface</h3>
406    
# Line 466  method</dt> Line 560  method</dt>
560      <code>manakaiEntityBaseURI</code>, and      <code>manakaiEntityBaseURI</code>, and
561      <code>manakaiEntityURI</code> <span class=ed>@@ ref</span></dt>      <code>manakaiEntityURI</code> <span class=ed>@@ ref</span></dt>
562        <dd>No explicit value is set.</dd>        <dd>No explicit value is set.</dd>
563      <dt><code>manakaiHasReplacementTree</code> and      <dt><a href="#hasReplacementTree"><code>hasReplacementTree</code></a> and
564      <code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>      <code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
565        <dd><code>false</code>.</dd>        <dd><code>false</code>.</dd>
566      <dt><code>nodeName</code></dt>      <dt><code>nodeName</code></dt>
# Line 634  If the new Line 728  If the new
728  <div class=section id=section-documenttypedefinition>  <div class=section id=section-documenttypedefinition>
729  <h3>The <code>DocumentTypeDefinition</code> Interface</h3>  <h3>The <code>DocumentTypeDefinition</code> Interface</h3>
730    
731    <div class="note memo">
732    <p>This interface is a separated interface from the
733    <a href="#DocumentType"><code>DocumentType</code></a>, not a set of extensions
734    to the <a href="#DocumentType"><code>DocumentType</code></a>,
735    for the historical reason.</p>
736    </div>
737    
738  <p>The  <p>The
739  <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>  <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
740  interface <em class=rfc2119>MUST</em> be implemented as following:</p>  interface <em class=rfc2119>MUST</em> be implemented as following:</p>
# Line 770  the node is read-only. Note that the [CO Line 871  the node is read-only. Note that the [CO
871  and therefore any change of read-only flag on the node is immediately  and therefore any change of read-only flag on the node is immediately
872  reflected by that of the object.  reflected by that of the object.
873  -->  -->
874    <dt><dfn id=getElementTypeDefinitionNode class=dom-method><code>getElementTypeDefinitionNode</code></dfn>,
875    method</dt>
876      <dd><p>Returns the
877      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
878      with the specified name.</p>
879    
880      <p>The
881      <dfn id=getElementTypeDefinitionNode-name class=dom-param><var>name</var></dfn>
882      parameter is the name of the element type.</p>
883    
884      <p>When invoked, the method <em class=rfc2119>MUST</em> return the
885      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node,
886      whose <a href="#nodeName"><code>nodeName</code></a> is equal to
887      <a href="#getElementTypeDefinitionNode-name"><var>name</var></a>, in the
888      <code>NamedNodeMap</code> object in the
889      <a href="#elementTypes"><code>elementTypes</code></a> attribute of the
890      node.  If there is no such node, it <em class=rfc2119>MUST</em> return
891      <code>null</code>.</p></dd>
892    <dt><dfn id=getElementTypeDefinitionNode class=dom-method><code>getElementTypeDefinitionNode</code></dfn>,
893    method</dt>
894      <dd><p>Returns the
895      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
896      with the specified name.</p>
897    
898      <p>The
899      <dfn id=getElementTypeDefinitionNode-name class=dom-param><var>name</var></dfn>
900      parameter is the name of the element type.</p>
901    
902      <p>When invoked, the method <em class=rfc2119>MUST</em> return the
903      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node,
904      whose <a href="#nodeName"><code>nodeName</code></a> is equal to
905      <a href="#getElementTypeDefinitionNode-name"><var>name</var></a>, in the
906      <code>NamedNodeMap</code> object in the
907      <a href="#elementTypes"><code>elementTypes</code></a> attribute of the
908      node.  If there is no such node, it <em class=rfc2119>MUST</em> return
909      <code>null</code>.</p></dd>
910    <dt><dfn id=getGeneralEntityNode class=dom-method><code>getGeneralEntityNode</code></dfn>,
911    method</dt>
912      <dd><p>Returns the <a href="#Entity"><code>Entity</code></a> node
913      with the specified name.</p>
914    
915      <p>The <dfn id=getEntityNode-name class=dom-param><var>name</var></dfn>
916      parameter is the name of the general entity.</p>
917    
918  <dt class=ed>@@ other members...    <p>When invoked, the method <em class=rfc2119>MUST</em> return the
919      <a href="#Entity"><code>Entity</code></a> node,
920      whose <a href="#nodeName"><code>nodeName</code></a> is equal to
921      <a href="#getEntityNode-name"><var>name</var></a>, in the
922      <code>NamedNodeMap</code> object in the
923      <a href="#entities"><code>entities</code></a> attribute of the
924      node.  If there is no such node, it <em class=rfc2119>MUST</em> return
925      <code>null</code>.</p></dd>
926    <dt><dfn id=getNotationNode class=dom-method><code>getNotationNode</code></dfn>,
927    method</dt>
928      <dd><p>Returns the <a href="#Notation"><code>Notation>/code></a> node
929      with the specified name.</p>
930    
931      <p>The
932      <dfn id=getNotationNode-name class=dom-param><var>name</var></dfn>
933      parameter is the name of the notation.</p>
934    
935      <p>When invoked, the method <em class=rfc2119>MUST</em> return the
936      <a href="#Notation"><code>Notation</code></a> node,
937      whose <a href="#nodeName"><code>nodeName</code></a> is equal to
938      <a href="#getNotationNode-name"><var>name</var></a>, in the
939      <code>NamedNodeMap</code> object in the
940      <a href="#notations"><code>notations</code></a> attribute of the
941      node.  If there is no such node, it <em class=rfc2119>MUST</em> return
942      <code>null</code>.</p></dd>
943    <dt><dfn id=setElementTypeDefinitionNode class=dom-method><code>setElementTypeDefinitionNode</code></dfn>,
944    method</dt>
945      <dd class=ed>@@</dd>
946    <dt><dfn id=setGeneralEntityNode class=dom-method><code>setGeneralEntityNode</code></dfn>,
947    method</dt>
948      <dd class=ed>@@</dd>
949    <dt><dfn id=setNotationNode class=dom-method><code>setNotationNode</code></dfn>,
950    method</dt>
951      <dd class=ed>@@</dd>
952  </dl>  </dl>
953    
954  <div class=ed>  <div class=ed>
# Line 784  reflected by that of the object. Line 961  reflected by that of the object.
961  <div class=section id=section-elementtypedefinition>  <div class=section id=section-elementtypedefinition>
962  <h3>The <code>ElementTypeDefinition</code> Interface</h3>  <h3>The <code>ElementTypeDefinition</code> Interface</h3>
963    
964    <p>The nodes of type
965    <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>
966    represents an element type definition.  Such a node implements the
967    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
968    interface, which extends the <a href="#Node"><code>Node</code></a>
969    interface.</p>
970    
971    <p>An element type definition represents a definition of the element type.
972    It is corresponding to the element type declaration in <abbr>DTD</abbr>.
973    However, an
974    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
975    does not represent the element type definition in <abbr>DTD</abbr> itself.  
976    Even if there are more than one element type declarations for an element type
977    in <abbr>DTD</abbr>, the result <abbr>DOM</abbr> will contain only an
978    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
979    node for that element type.  In addition, if there are attribute definition
980    declarations for an element type, even when there is no element type
981    declaration for that element type, the <abbr>DOM</abbr> will contain an
982    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
983    node for that element type.</p>
984    
985  <p>The <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>  <p>The <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
986  interface <em class=rfc2119>MUST</em> be implemented as following:</p>  interface <em class=rfc2119>MUST</em> be implemented as following:</p>
987  <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> {
988    readonly attribute <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;    readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
989    
990    <span class=ed>@@ more</span>    <span class=ed>@@ more</span>
991  }</code></pre>  }</code></pre>
992    
993  <pre class=ed>  <dl>
994  [DFN@en[[CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute]]  <dt><dfn id=ownerDocumentTypeDefinition class=dom-attr><code>ownerDocumentTypeDefinition</code></dfn>
995  of the [CODE(DOMi)@en[[[ElementTypeDefinition]]]]  of type <a href="#DocumentType"><code>DocumentType</code></a>, read$B!>(Bonly</dt>
996  interface is defined in [[manakai//DOM Extensions]>>50].</pre>    <dd><p>The
997      <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
998      attribute of
999      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
1000      <a href="#Entity"><code>Entity</code></a>, and
1001      <a href="#Notation"><code>Notation</code></a> interface contains the
1002      <a href="#DocumentType"><code>DocumentType</code></a> node to which the node
1003      is attached.</p>
1004    
1005      <p>On getting, the attribute <em class=rfc2119>MUST</em> return a
1006      <a href="#DocumentType"><code>DocumentType</code></a> node.  It
1007      <em class=rfc2119>MUST</em> be such a node that whose
1008      <a href="#elementTypes"><code>elementTypes</code></a> (for an
1009      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1010      node), <a href="#entities"><code>entities</code></a> (for an
1011      <a href="#Entity"><code>Entity</code></a> node), or
1012      <a href="#notations"><code>notations</code></a> (for a
1013      <a href="#Notation"><code>Notation</code></a> node) attribute contains the
1014      <code>NamedNodeMap</code> object that contains the node.  If there is no such
1015      a <a href="#DocumentType"><code>DocumentType</code></a> node,
1016      then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p></dd>
1017    </dl>
1018    
1019    <div class=ed>
1020    <p>A future version of the specification might define a set of attributes
1021    and methods for representing and accessing to the content model of the
1022    element type.</p>
1023    </div>
1024  </div>  </div>
1025    
1026  <div class=section id=section-attributedefinition>  <div class=section id=section-attributedefinition>
1027  <h3>The <code>AttributeDefinition</code> Interface</h3>  <h3>The <code>AttributeDefinition</code> Interface</h3>
1028    
1029    <p>The nodes of type
1030    <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>
1031    represents an attribute definition.  Such a node implements the
1032    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> interface,
1033    which extends the <a href="#Node"><code>Node</code></a> interface.</p>
1034    
1035    <p>An attribute definition represents a definition of the attribute
1036    associated to an element type.  It is corresponding to the attribute definition
1037    in the attribute list declaration in <abbr>DTD</abbr>.  However, an
1038    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node does
1039    not represent the attribute definition in <abbr>DTD</abbr> itself.  Even if
1040    there are more than one attribute definitions for an attribute of an element
1041    type in <abbr>DTD</abbr>, the result <abbr>DOM</abbr> will contain only an
1042    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node for
1043    that attribute.</p>
1044    
1045  <p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>  <p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1046  interface <em class=rfc2119>MUST</em> be implemented as following:</p>  interface <em class=rfc2119>MUST</em> be implemented as following:</p>
1047  <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> {
# Line 817  interface <em class=rfc2119>MUST</em> be Line 1058  interface <em class=rfc2119>MUST</em> be
1058    const unsigned short <a href="#NOTATION_ATTR">NOTATION_ATTR</a> = 9;    const unsigned short <a href="#NOTATION_ATTR">NOTATION_ATTR</a> = 9;
1059    const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10;    const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10;
1060    const unsigned short <a href="#UNKNOWN_ATTR">UNKNOWN_ATTR</a> = 11;    const unsigned short <a href="#UNKNOWN_ATTR">UNKNOWN_ATTR</a> = 11;
1061    
1062      <span class=comment>// <a href="#DefaultValueType">DefaultValueType</a></span>
1063      const unsigned short <a href="#UNKNOWN_DEFAULT">UNKNOWN_DEFAULT</a> = 0;
1064      const unsigned short <a href="#FIXED_DEFAULT">FIXED_DEFAULT</a> = 1;
1065      const unsigned short <a href="#REQUIRED_DEFAULT">REQUIRED_DEFAULT</a> = 2;
1066      const unsigned short <a href="#IMPLIED_DEFAULT">IMPLIED_DEFAULT</a> = 3;
1067      const unsigned short <a href="#EXPLICIT_DEFAULT">EXPLICIT_DEFAULT</a> = 4;
1068        
1069    readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;    readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;
1070    
# Line 1018  type <code>unsigned short</code></dt> Line 1266  type <code>unsigned short</code></dt>
1266    
1267  </div>  </div>
1268    
1269    <div class=section id=section-entity>
1270    <h3>Modifications to the <code id=Entity>Entity</code> Interface</h3>
1271    
1272    <p>The implementation of the <a href="#Entity"><code>Entity</code></a>
1273    interface <em class=rfc2119>MUST</em> be modified as following:</p>
1274    <pre class=idl><code>// Modifications to the Entity interface
1275      attribute DOMString <a href="#publicId">publicId</a>;
1276      attribute DOMString <a href="#systemId">systemId</a>;
1277      attribute DOMString <a href="#notationName">notationName</a>;
1278    
1279      // Additions to the Entity interface
1280      attribute DOMString <a href="#hasReplacementTree">hasReplacementTree</a>;
1281      readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
1282    
1283      attribute boolean <a href="#isExternallyDeclared">isExternallyDeclared</a>;
1284    </code></pre>
1285    
1286    <p>The <code id=notationName>notationName</code> attribute of the
1287    <a href="#Entity"><code>Entity</code></a> interface is no longer
1288    read$B!>(Bonly.</p>
1289    
1290    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1291    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
1292    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.
1293    Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value
1294    associated to the attribute.  No lexical validation is performed.  The new
1295    value <em class=rfc2119>MAY</em> be <code>null</code>.</p>
1296    
1297    <dl>
1298    <dt><dfn id=hasReplacementTree class=dom-attr><code>hasReplacementTree</code></dfn>
1299    of type boolean</dt>
1300      <dd><p>Whether the structure of the replacement text of the entity
1301      is available via the <code>NodeList</code> object in the
1302      <code>childNodes</code> attribute of the entity.</p>
1303    
1304      <p>On getting, the attribute <em class=rfc2119>MUST</em> return
1305      the value associated to this attribute.</p>
1306    
1307      <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1308      <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
1309      exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.  
1310      Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the
1311      value associated to this attribute.</p>
1312    
1313      <div class="note memo">
1314      <p>The attribute can be set to <code>false</code> even if the
1315      <a href="#Entity"><code>Entity</code></a> node has any child node.
1316      If the attribute is set to <code>false</code>, then any child node of
1317      the <a href="#Entity"><code>Entity</code></a> node ought to be ignored,
1318      say, for the purpose of serialization.</p>
1319      </div>
1320    
1321      <p>When an <code>EntityReference</code> node is created by cloning
1322      the replacement subtree of the <a href="#Entity"><code>Entity</code></a>
1323      node, if the attribute is set to <code>false</code>, then any descendant
1324      of the node <em class=rfc2119>MUST</em> be ignored.</p>
1325    
1326      <p>If the <a href="#Entity"><code>Entity</code></a> node is created during
1327      the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document,
1328      the following requirements are applied:  If the entity is an unparsed
1329      entity, then the attribute <em class=rfc2119>MUST</em> be set to
1330      <code>false</code>.  Otherwise, if the entity is an external entity whose
1331      replacement text is not available, or whose replacement text is not converted
1332      to a replacement tree, then the attribute <em class=rfc2119>MUST</em> be set
1333      to <code>false</code>.  Otherwise, the attribute
1334      <em class=rfc2119>MUST</em> be set to <code>true</code>.</p>
1335    
1336      <div class="note memo">
1337      <p>An <a href="#Entity"><code>Entity</code></a> node created by the
1338      <a href="#createGeneralEntity"><code>createGeneralEntity</code></a> method
1339      has its <a href="#hasReplacementTree"><code>hasReplacementTree</code></a>
1340      attribute set to <code>false</code>.</p>
1341      </div></dd>
1342    <dt><dfn id=isExternallyDeclared class=dom-attr><code>isExternallyDeclared</code></dfn>
1343    of type boolean</dt>
1344      <dd><p>Whether the entity is declared by an external entity declaration or
1345      not.  If the value is <code>true</code>, the entity is declared in an entity
1346      declaration in the external subset entity or in an external parameter entity.
1347      If the value is <code>false</code>, the entity is declared in an entity
1348      declaration in the internal subset, or the node is created in memory.</p>
1349    
1350      <p>On getting, the attribute <em class=rfc2119>MUST</em> return
1351      the value associated to this attribute.</p>
1352    
1353      <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1354      <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
1355      exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.  
1356      Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the
1357      value associated to this attribute.</p>
1358    
1359      <p>If the <a href="#Entity"><code>Entity</code></a> node is created during
1360      the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document,
1361      the following requirements are applied:  If the entity is an unparsed
1362      entity, then the attribute <em class=rfc2119>MUST</em> be set to
1363      <code>false</code>.  Otherwise, i.e. the entity is a parsed entity, then the
1364      attribute <em class=rfc2119>MUST</em> be set to the value of whether the
1365      entity is declared by an external markup declaration or not.</p></dd>
1366    </dl>
1367  </div>  </div>
1368    
1369    <div class=section id=section-notation>
1370    <h3>Modifications to the <code id=Notation>Notation</code> Interface</h3>
1371    
1372    <p>The implementation of the <a href="#Notation"><code>Notation</code></a>
1373    interface <em class=rfc2119>MUST</em> be modified as following:</p>
1374    <pre class=idl><code>// Modifications to the Notation interface
1375      attribute DOMString <a href="#publicId">publicId</a>;
1376      attribute DOMString <a href="#systemId">systemId</a>;
1377    
1378      // Addition to the Notation interface
1379      readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
1380    </code></pre>
1381    </div>
1382    
1383    </div>
1384    
1385  <div id="references" class="section reference">  <div id="references" class="section reference">
1386  <h2>References</h2>  <h2>References</h2>
Legend:
Removed from v.1.16  
changed lines
  Added in v.1.20
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24