/[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.17 by wakaba, Tue Dec 4 11:01:49 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 777  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      <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  <dt class=ed>@@ other members...    <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 815  node for that element type.</p> Line 985  node for that element type.</p>
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>
# Line 1069  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.17  
changed lines
  Added in v.1.20
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24