/[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.12 by wakaba, Mon Dec 3 11:04:29 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>
179    
180    <div class=section id=section-node>
181    <h3>Modifications to the <code id=Node>Node</code> Interface</h3>
182    
183    <p>The implementation of the
184    <a href="#Node"><code>Node</code></a> interface
185    <em class=rfc2119>MUST</em> be modified as following:</p>
186    <pre class=idl><code>// Additions to the Node interface
187    
188    // Additions to the NodeType definition group
189    const unsigned short <a href="#ELEMENT_TYPE_DEFINITION_NODE">ELEMENT_TYPE_DEFINITION_NODE</a> = 81001;
190    const unsigned short <a href="#ATTRIBUTE_DEFINITION_NODE">ATTRIBUTE_DEFINITION_NODE</a> = 81002;
191    </pre>
192    
193    <p>This specification adds two new types (subinterfaces) of
194    <a href="#Node"><code>Node</code></a>: element type definition (node type
195    <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>,
196    interface
197    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) and
198    attribute definition (node type
199    <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>,
200    interface
201    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>).  For
202    these kinds of nodes, methods and attributes in the
203    <a href="#Node"><code>Node</code></a> interface must behave as following:</p>
204    
205    <dl>
206    <dt><code id=attributes>attributes</code></dt>
207      <dd>
208        <p>On getting, the attribute <em class=rfc2119>MUST</em> return
209        <code>null</code>.</p>
210      </dd>
211    <dt><code id=baseURI>baseURI</code></dt>
212      <dd>
213        <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
214        value of the <a href="#baseURI"><code>baseURI</code></a> attribute
215        of the node in the <code>ownerDocument</code> attribute of the node.
216        Note that the value might be <code>null</code>.</p>
217      </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>
288      <dd>
289        <p>If the node is an
290        <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
291        On getting, the attribute <em class=rfc2119>MUST</em> return the
292        name of the element type definition represented by the node.</p>
293    
294        <p>If the node is an
295        <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:
296        On getting, the attribute <em class=rfc2119>MUST</em> return the
297        name of the attribute definition represented by the node.</p>
298      </dd>
299    <dt><code id=nodeType>nodeType</code></dt>
300      <dd>
301        <p>On getting, the attribute <em class=rfc2119>MUST</em> return
302        <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>
303        (if the node is an
304        <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) or
305        <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>
306        (if the node is an
307        <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>).</p>
308    
309        <!-- NodeType -->
310    <p>Two constants are added to the <code id=NodeType>NodeType</code>
311    definition group of the <a href="#Node"><code>Node</code></a> interface as
312    following:</p>
313    <table>
314    <thead>
315    <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
316    </thead>
317    <tbody>
318    <tr>
319    <th scope=row><dfn id=ELEMENT_TYPE_DEFINITION_NODE class=dom-const><code>ELEMENT_TYPE_DEFINITION_NODE</code></dfn>
320    <td><code>81001</code><td>The node is an
321    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>.</tr>
322    <tr>
323    <th scope=row><dfn id=ATTRIBUTE_DEFINITION_NODE class=dom-const><code>ATTRIBUTE_DEFINITION_NODE</code></dfn>
324    <td><code>81002</code><td>The node is an
325    <a href="#ElementTypeDefinition"><code>AttributeDefinition</code></a>.</tr>
326    </tbody>
327    </table>
328      </dd>
329    <dt><code id=nodeValue>nodeValue</code> and
330    <code id=textContent>textContent</code></dt>
331      <dd>
332        <p>If the node is an
333        <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
334        On getting, the attributes <em class=rfc2119>MUST</em> return the
335        name of the element type.</p>
336    
337        <div class="note memo">
338          <p>Thus, on setting the attributes does nothing
339          <span class=ed>[DOM3]</span>.</p>
340        </div>
341    
342        <p>On setting, the <a href="#textContent"><code>textContent</code></a>
343        attribute <em class=rfc2119>MUST NOT</em> raise a
344        <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>.
345        <span class=ed>@@ I forgot why this requirement is necessary.</span></p>
346    
347        <p>If the node is an
348        <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:</p>
349    
350        <pre class=ed>
351    The getter of the [CODE(DOMa)@en[[[nodeValue]]]] attribute
352    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
353    [['''MUST''']] return the normalized default value
354    of the attribute.
355    
356    @@
357    
358    [4] The getter of the [CODE(DOMa)@en[[[textContent]]]]
359    attribute of an [CODE(DOMi)@en[[[AttributeDefinition]]]]
360    object [['''MUST''']] behave as if it were an
361    [CODE(DOMi)@en[[[Attr]]]] object.
362    
363    The setter of the [CODE(DOMa)@en[[[textContent]]]] attribute
364    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
365    [['''MUST''']] behave as if the following algorithm
366    is performed:
367    = If the [CODE(DOMi)@en[[[AttributeDefinition]]]]
368    object is read-only, then throw an
369    [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].
370    = Remove any child node the node has.
371    = If the new value is not empty and not [CODE(IDL)@en[[[null]]]],
372    then create a [CODE(DOMi)@en[[[Text]]]] node
373    whose [CODE(DOMa)@en[[[data]]]] is the new value
374    and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].
375    </pre>
376      </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>
389    </dl>
390    
391    </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>  </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    
407    <p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface
408    <em class=rfc2119>MUST</em> be implemented as following:</p>
409  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {
410    DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>    DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>
411      (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)      (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)
# Line 331  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 405  define it for <code>Document</code> meth Line 634  define it for <code>Document</code> meth
634    
635  </div>  </div>
636    
637    
638    <div class=section id=section-documenttype>
639    <h3>Modifications to the <code id=DocumentType>DocumentType</code>
640    Interface</h3>
641    
642    <p>A <a href="#DocumentType"><code>DocumentType</code></a> interface
643    <em class=rfc2119>MAY</em> contain zero or more
644    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
645    nodes in the <code>NodeList</code> object contained in the
646    <code>childNodes</code> attribute of the
647    <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
648    
649    <p>If the <a href="#DocumentType"><code>DocumentType</code></a> node is created
650    during the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr>
651    document, the <code>NodeList</code> object in the <code>childNodes</code>
652    object <em class=rfc2119>MUST</em> contains the
653    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
654    nodes representing the processing instructions in the document type
655    definition of the document processed <span class=ed>@@ ref</span> by
656    the <abbr>XML</abbr> processor.  If the
657    <a href="#DocumentType"><code>DocumentType</code></a> node is marked
658    as read$B!>(Bonly, then all the child nodes <em class=rfc2119>MUST</em>
659    also be marked as read$B!>(Bonly.</p>
660    
661    <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is created
662    from a document type declaration information item <span class=ed>@@ ref</span>,
663    the <code>NodeList</code> object in the <code>childNodes</code> attribute
664    of the node <em class=rfc2119>MUST</em> contain the
665    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes
666    created from the processing instruction information items in the list in the
667    [children] property of the document type declaration item in the same
668    order.</p>
669    
670    <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is mapped to
671    a document type declaration information item, the list in the [children]
672    property <em class=rfc2119>MUST</em> contain the processng instruction
673    information items created from the
674    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes
675    in the <code>NodeList</code> object in the <code>childNodes</code> attribute
676    of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
677    
678    <p>The implementation of the
679    <a href="#DocumentType"><code>DocumentType</code></a> interface
680    <em class=rfc2119>MUST</em> be modified as following:</p>
681    <pre class=idl><code>// Modifications to the DocumentType interface
682      attribute DOMString <a href="#publicId">publicId</a>;
683      attribute DOMString <a href="#systemId">systemId</a>;
684    
685      attribute DOMString <a href="#internalSubset">internalSubset</a>;
686    </code></pre>
687    
688    <p>The <code id=publicId>publicId</code> attribute and the
689    <code id=systemId>systemId</code> attribute of
690    <a href="#DocumentType"><code>DocumentType</code></a>,
691    <a href="#Entity"><code>Entity</code></a>, and
692    <a href="#Notation"><code>Notation</code></a> interfaces are no longer
693    read$B!>(Bonly.</p>
694    
695    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
696    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
697    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.  
698    Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value
699    associated to the attribute.  No normalization, relative reference resolution,
700    or lexical validation is performed. <span class=ed>@@ If the new
701    value is <code>null</code>, ...</span></p>
702    
703    <div class="note memo">
704    <p>Setting an invalid identifier might make the node unserializable.
705    Setting a public identifier while leaveing system identifier unspecified
706    would also make the <a href="#DocumentType"><code>DocumentType</code></a>
707    or <a href="#Entity"><code>Entity</code></a> node unserializable.</p>
708    </div>
709    
710    <div class=ed>
711    <p>ISSUE: In HTML5, Firefox 1.5, and Opera 9, not specifying public or system identifier results in empty strings.</p>
712    </div>
713    
714    <p>The <code id=internalSubset>internalSubset</code> attribute of the
715    <a href="#DocumentType"><code>DocumentType</code></a> interface is no longer
716    read$B!>(Bonly.</p>
717    
718    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
719    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
720    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.  
721    Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value
722    associated to the attribute.  No normalization, or lexical validation is
723    performed. <span class=ed>@@ If the new value is <code>null</code>,
724    ...</span></p>
725    
726    </div>
727    
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
739    <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
740    interface <em class=rfc2119>MUST</em> be implemented as following:</p>
741  <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {  <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {
742    readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>;    readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>;
743    readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>;    readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>;
744    readonly attribute NamedNodeMap <a href="#notations">notations</a>;    readonly attribute NamedNodeMap <a href="#notations">notations</a>;
745    
746    <span class=ed>more members come here...</span>    <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#getElementTypeDefinitionNode">getElementTypeDefinitionNode</a>
747        (in DOMString <a href="#getElementTypeDefinitionNode-name"><var>name</var></a>);
748      <a href="#Entity">Entity</a> <a href="#getGeneralEntityNode">getGeneralEntityNode</a>
749        (in DOMString <a href="#getGeneralEntityNode-name"><var>name</var></a>);
750      <a href="#Notation">Notation</a> <a href="#getNotationNode">getNotationNode</a>
751        (in DOMString <a href="#getNotationNode-name"><var>name</var></a>);
752    
753      void <a href="#setElementTypeDefinitionNode">setElementTypeDefinitionNode</a>
754        (in DOMString <a href="#setElementTypeDefinitionNode-node"><var>node</var></a>)
755        raises (DOMException);
756      void <a href="#setGeneralEntityNode">setGeneralEntityNode</a>
757        (in DOMString <a href="#setGeneralEntityNode-node"><var>node</var></a>)
758        raises (DOMException);
759      void <a href="#setNotationNode">setNotationNode</a>
760        (in DOMString <a href="#setNotationNode-node"><var>node</var></a>)
761        raises (DOMException);
762  }</code></pre>  }</code></pre>
763    
764  <pre class=ed>  <pre class=ed>
# Line 526  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 540  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>
986    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>** Modifications to [CODE(DOMi)@en[[[Node]]]] members  <dl>
994    <dt><dfn id=ownerDocumentTypeDefinition class=dom-attr><code>ownerDocumentTypeDefinition</code></dfn>
995  [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute  of type <a href="#DocumentType"><code>DocumentType</code></a>, read$B!>(Bonly</dt>
996  of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object    <dd><p>The
997  [['''MUST''']] return [CODE(IDL)@en[[[null]]]].    <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
998      attribute of
999  [4] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
1000  of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object    <a href="#Entity"><code>Entity</code></a>, and
1001  [['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]    <a href="#Notation"><code>Notation</code></a> interface contains the
1002  of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the    <a href="#DocumentType"><code>DocumentType</code></a> node to which the node
1003  [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object.    is attached.</p>
1004  Note that it might be [CODE(IDL)@en[[[null]]]].  
1005      <p>On getting, the attribute <em class=rfc2119>MUST</em> return a
1006  [1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute    <a href="#DocumentType"><code>DocumentType</code></a> node.  It
1007  of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object    <em class=rfc2119>MUST</em> be such a node that whose
1008  [['''MUST''']] return the name of the element type.    <a href="#elementTypes"><code>elementTypes</code></a> (for an
1009      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1010  [2] The getters of the [CODE(DOMa)@en[[[nodeValue]]]]    node), <a href="#entities"><code>entities</code></a> (for an
1011  and [CODE(DOMa)@en[[[textContent]]]] attributes    <a href="#Entity"><code>Entity</code></a> node), or
1012  of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]    <a href="#notations"><code>notations</code></a> (for a
1013  object [['''MUST''']] return [CODE(IDL)@en[[[null]]]].    <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  ;; Thus, the setter of these attributes do nothing.    a <a href="#DocumentType"><code>DocumentType</code></a> node,
1016      then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p></dd>
1017  The setter of the [CODE(DOMa)@en[[[textContent]]]]  </dl>
 attribute of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]  
 object [['''MUST NOT''']] throw a  
 [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].  
   
 ** The [CODE(DOMi)@en[ElementTypeDefinition]] Interface  
1018    
1019  [5] The  <div class=ed>
1020  [DFN@en[[CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute]]  <p>A future version of the specification might define a set of attributes
1021  of the [CODE(DOMi)@en[[[ElementTypeDefinition]]]]  and methods for representing and accessing to the content model of the
1022  interface is defined in [[manakai//DOM Extensions]>>50].</pre>  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>
1046    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> {
1048    <span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span>    <span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span>
1049    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;
# Line 600  interface is defined in [[manakai//DOM E Line 1058  interface is defined in [[manakai//DOM E
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 609  interface is defined in [[manakai//DOM E Line 1074  interface is defined in [[manakai//DOM E
1074    <span class=ed>...</span>    <span class=ed>...</span>
1075  }</code></pre>  }</code></pre>
1076    
 <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members  
   
 [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute  
 of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  
 [['''MUST''']] return [CODE(IDL)@en[[[null]]]].  
   
 [9] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute  
 of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  
 [['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]  
 of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the  
 [CODE(DOMi)@en[[[AttributeDefinition]]]] object.  
 Note that it might be [CODE(IDL)@en[[[null]]]].  
   
 [1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute  
 of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  
 [['''MUST''']] return the name of the attribute.  
   
 [2] The getter of the [CODE(DOMa)@en[[[nodeValue]]]] attribute  
 of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  
 [['''MUST''']] return the normalized default value  
 of the attribute.  
   
 @@  
   
 [4] The getter of the [CODE(DOMa)@en[[[textContent]]]]  
 attribute of an [CODE(DOMi)@en[[[AttributeDefinition]]]]  
 object [['''MUST''']] behave as if it were an  
 [CODE(DOMi)@en[[[Attr]]]] object.  
   
 The setter of the [CODE(DOMa)@en[[[textContent]]]] attribute  
 of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  
 [['''MUST''']] behave as if the following algorithm  
 is performed:  
 = If the [CODE(DOMi)@en[[[AttributeDefinition]]]]  
 object is read-only, then throw an  
 [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].  
 = Remove any child node the node has.  
 = If the new value is not empty and not [CODE(IDL)@en[[[null]]]],  
 then create a [CODE(DOMi)@en[[[Text]]]] node  
 whose [CODE(DOMa)@en[[[data]]]] is the new value  
 and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].  
 </pre>  
   
1077  <dl>  <dl>
1078  <dt><dfn id=ownerElementTypeDefinition class=dom-attr><code>ownerElementTypeDefinition</code></dfn>  <dt><dfn id=ownerElementTypeDefinition class=dom-attr><code>ownerElementTypeDefinition</code></dfn>
1079  of type  of type
# Line 844  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-documenttype>  <div class=section id=section-entity>
1270  <h3>Modifications to the <code id=DocumentType>DocumentType</code>  <h3>Modifications to the <code id=Entity>Entity</code> Interface</h3>
 Interface</h3>  
1271    
1272  <p>A <a href="#DocumentType"><code>DocumentType</code></a> interface  <p>The implementation of the <a href="#Entity"><code>Entity</code></a>
1273  <em class=rfc2119>MAY</em> contain zero or more  interface <em class=rfc2119>MUST</em> be modified as following:</p>
1274  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>  <pre class=idl><code>// Modifications to the Entity interface
1275  nodes in the <code>NodeList</code> object contained in the    attribute DOMString <a href="#publicId">publicId</a>;
1276  <code>childNodes</code> attribute of the    attribute DOMString <a href="#systemId">systemId</a>;
1277  <a href="#DocumentType"><code>DocumentType</code></a> node.</p>    attribute DOMString <a href="#notationName">notationName</a>;
1278    
1279  <p>If the <a href="#DocumentType"><code>DocumentType</code></a> node is created    // Additions to the Entity interface
1280  during the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr>    attribute DOMString <a href="#hasReplacementTree">hasReplacementTree</a>;
1281  document, the <code>NodeList</code> object in the <code>childNodes</code>    readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
 object <em class=rfc2119>MUST</em> contains the  
 <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>  
 nodes representing the processing instructions in the document type  
 definition of the document processed <span class=ed>@@ ref</span> by  
 the <abbr>XML</abbr> processor.  If the  
 <a href="#DocumentType"><code>DocumentType</code></a> node is marked  
 as read$B!>(Bonly, then all the child nodes <em class=rfc2119>MUST</em>  
 also be marked as read$B!>(Bonly.</p>  
1282    
1283  <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is created    attribute boolean <a href="#isExternallyDeclared">isExternallyDeclared</a>;
1284  from a document type declaration information item <span class=ed>@@ ref</span>,  </code></pre>
 the <code>NodeList</code> object in the <code>childNodes</code> attribute  
 of the node <em class=rfc2119>MUST</em> contain the  
 <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes  
 created from the processing instruction information items in the list in the  
 [children] property of the document type declaration item in the same  
 order.</p>  
1285    
1286  <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is mapped to  <p>The <code id=notationName>notationName</code> attribute of the
1287  a document type declaration information item, the list in the [children]  <a href="#Entity"><code>Entity</code></a> interface is no longer
1288  property <em class=rfc2119>MUST</em> contain the processng instruction  read$B!>(Bonly.</p>
1289  information items created from the  
1290  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes  <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1291  in the <code>NodeList</code> object in the <code>childNodes</code> attribute  <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
1292  of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>  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  <pre class=idl><code>// Modifications to the DocumentType interface  <dl>
1298    attribute DOMString <a href="#publicId">publicId</a>;  <dt><dfn id=hasReplacementTree class=dom-attr><code>hasReplacementTree</code></dfn>
1299    attribute DOMString <a href="#systemId">systemId</a>;  of type boolean</dt>
1300  </code></pre>    <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 class=ed>    <p>On getting, the attribute <em class=rfc2119>MUST</em> return
1305   The publicId attribute and the systemId attribute of DocumentType, Entity, and Notation objects are now read-write.    the value associated to this attribute.</p>
1306    
1307  The setter MUST throw a NO_MODIFICATION_ALLOWED_ERR DOMException if the Node object is read-only. Otherwise, it MUST set the specified value to the attribute. No normalization, lexical validation, or relative reference resolving is performed. null, which represents no public or system identifier is provided, might be specified.    <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  Setting public or system identifier does never result in any lexical or logical structure of the document being changed. In particular, no external entity referenced by new identifier will be loaded.    <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  Setting an invalid or non-normalized identifier might make the object non-serializable. Setting a non-null public identifier to a DocumentType or Entity object that does not have non-null system identifier or setting null as the system identifier of a DocumentType or Entity object that does have non-null public identifier will make that object non-serializable.    <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  ISSUE: In HTML5, Firefox 1.5, and Opera 9, not specifying public or system identifier results in empty strings.    <p>On getting, the attribute <em class=rfc2119>MUST</em> return
1351  </pre>    the value associated to this attribute.</p>
1352    
1353  </div>    <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.12  
changed lines
  Added in v.1.20
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24