/[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.9 by wakaba, Sun Dec 2 10:44:42 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-01>1 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 125  raised is undefined.</p> Line 125  raised is undefined.</p>
125  interface.</p>  interface.</p>
126    
127  <p class=ed>@@ ref to DOM Binding Spec</p>  <p class=ed>@@ ref to DOM Binding Spec</p>
128    
129    <p>If the <code>strictErrorChecking</code> attribute of the
130    <code>Document</code> node is <code>false</code>, the methods are
131    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 adds methods, attributes, and/or constants to interfaces  
150  <a href="#Node"><code>Node</code></a>,  <a href="#Node"><code>Node</code></a>,
151  <a href="#Entity"><code>Entity</code></a>,  <a href="#Document"><code>Document</code></a>,
152  <a href="#EntityReference"><code>EntityReference</code></a>, and  <a href="#DocumentType"><code>DocumentType</code></a>,
153  <a href="#Notation"><code>Notation</code></a>.  <a href="#Entity"><code>Entity</code></a>, and
154  It modifies semantics of some of methods and attributes in  <a href="#Notation"><code>Notation</code></a>.</p>
 <a href="#Node"><code>Node</code></a> and  
 <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>  
 interfaces, for the support of new interfaces.</p>  
155    
156  <div class=section id=features>  <div class=section id=features>
157  <h3>Feature Name</h3>  <h3>Feature Name</h3>
# Line 156  interfaces, for the support of new inter Line 160  interfaces, for the support of new inter
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>)
412      raises (DOMException);      raises (DOMException);
413    ElementTypeDefinition <a href="#createElementTypeDefinition">createElementTypeDefinition</a>    <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#createElementTypeDefinition">createElementTypeDefinition</a>
414      (in DOMString <a href="#createElementTypeDefinition-name"><var>name</var></a>)      (in DOMString <a href="#createElementTypeDefinition-name"><var>name</var></a>)
415      raises (DOMException);      raises (DOMException);
416    AttributeDefinition <a href="#createAttributeDefinition">createAttributeDefinition</a>    <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#createAttributeDefinition">createAttributeDefinition</a>
417      (in DOMString <a href="#createAttributeDefinition-name"><var>name</var></a>)      (in DOMString <a href="#createAttributeDefinition-name"><var>name</var></a>)
418      raises (DOMException);      raises (DOMException);
419    Entity <a href="#createGeneralEntity">createGeneralEntityDefinition</a>    <a href="#Entity">Entity</a> <a href="#createGeneralEntity">createGeneralEntityDefinition</a>
420      (in DOMString <a href="#createGeneralEntity-name"><var>name</var></a>)      (in DOMString <a href="#createGeneralEntity-name"><var>name</var></a>)
421      raises (DOMException);      raises (DOMException);
422    Notation <a href="#createNotation">createNotation</a>    <a href="#Notation">Notation</a> <a href="#createNotation">createNotation</a>
423      (in DOMString <a href="#createNotation-name"><var>name</var></a>)      (in DOMString <a href="#createNotation-name"><var>name</var></a>)
424      raises (DOMException);      raises (DOMException);
425  }</code></pre>  }</code></pre>
# Line 329  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 399  since <abbr>DOM3</abbr> specification <s Line 630  since <abbr>DOM3</abbr> specification <s
630  define it for <code>Document</code> methods.</p>  define it for <code>Document</code> methods.</p>
631    
632  <p><var>name</var> does not have to be a namespace qualified name.</p>  <p><var>name</var> does not have to be a namespace qualified name.</p>
633    </div>
634    
 <p>If the <code>strictErrorChecking</code> attribute of the  
 <code>Document</code> node is <code>false</code>, the methods are  
 not required to raise the exception <span class=ed>[DOM3]</span>.</p>  
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>  </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 528  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 542  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  <pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> {  <p>The nodes of type
965      <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>
966  }</code></pre>  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  <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members  <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> {
988      readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
989    
990  [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute    <span class=ed>@@ more</span>
991  of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object  }</code></pre>
 [['''MUST''']] return [CODE(IDL)@en[[[null]]]].  
   
 [4] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute  
 of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object  
 [['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]  
 of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the  
 [CODE(DOMi)@en[[[ElementTypeDefinition]]]] 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[[[ElementTypeDefinition]]]] object  
 [['''MUST''']] return the name of the element type.  
   
 [2] The getters of the [CODE(DOMa)@en[[[nodeValue]]]]  
 and [CODE(DOMa)@en[[[textContent]]]] attributes  
 of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]  
 object [['''MUST''']] return [CODE(IDL)@en[[[null]]]].  
   
 ;; Thus, the setter of these attributes do nothing.  
   
 The setter of the [CODE(DOMa)@en[[[textContent]]]]  
 attribute of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]  
 object [['''MUST NOT''']] throw a  
 [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].  
992    
993  ** The [CODE(DOMi)@en[ElementTypeDefinition]] Interface  <dl>
994    <dt><dfn id=ownerDocumentTypeDefinition class=dom-attr><code>ownerDocumentTypeDefinition</code></dfn>
995    of type <a href="#DocumentType"><code>DocumentType</code></a>, read$B!>(Bonly</dt>
996      <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  [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  <pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> {  <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> {
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;
1050    const unsigned short <a href="#CDATA_ATTR">CDATA_ATTR</a> = 1;    const unsigned short <a href="#CDATA_ATTR">CDATA_ATTR</a> = 1;
# 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;
     
   <span class=ed>...</span>  
 }</code></pre>  
1061    
1062  <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members    <span class=comment>// <a href="#DefaultValueType">DefaultValueType</a></span>
1063      const unsigned short <a href="#UNKNOWN_DEFAULT">UNKNOWN_DEFAULT</a> = 0;
1064  [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute    const unsigned short <a href="#FIXED_DEFAULT">FIXED_DEFAULT</a> = 1;
1065  of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object    const unsigned short <a href="#REQUIRED_DEFAULT">REQUIRED_DEFAULT</a> = 2;
1066  [['''MUST''']] return [CODE(IDL)@en[[[null]]]].    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>;
1070    
1071  [9] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute    readonly attribute unsigned short <a href="#declaredType">declaredType</a>;
1072  of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object    readonly attribute unsigned short <a href="#defaultType">defaultType</a>;
 [['''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]]]].  
1073    
1074  [1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute    <span class=ed>...</span>
1075  of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  }</code></pre>
 [['''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.  
1076    
1077  @@  <dl>
1078    <dt><dfn id=ownerElementTypeDefinition class=dom-attr><code>ownerElementTypeDefinition</code></dfn>
1079    of type
1080    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
1081    read$B!>(Bonly</dt>
1082      <dd><p>The
1083      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> to
1084      which the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1085      node belongs.</p>
1086    
1087      <p>On getting, the attribute <em class=rfc2119>MUST</em> return an
1088      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.
1089      It <em class=rfc2119>MUST</em> be such a node that whose
1090      <a href="#attributeDefinitons"><code>attributeDefinitions</code></a>
1091      attribute contains the <code>NamedNodeMap</code> object that contains
1092      the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1093      node.  If there is no such an
1094      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node,
1095      then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p>
1096    <dt><dfn id=declaredType class=dom-attr><code>declaredType</code></dfn> of type
1097    <code>unsigned short</code></dt>
1098      <dd><p>The declared type <span class=ed>@@ ref</span> of the attribute.
1099      It is expected that this attribute contains a value from the definition group
1100      <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>.</p>
1101    
1102  [4] The getter of the [CODE(DOMa)@en[[[textContent]]]]    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
1103  attribute of an [CODE(DOMi)@en[[[AttributeDefinition]]]]    value associated to this attribute.</p>
 object [['''MUST''']] behave as if it were an  
 [CODE(DOMi)@en[[[Attr]]]] object.  
1104    
1105  The setter of the [CODE(DOMa)@en[[[textContent]]]] attribute    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1106  of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
1107  [['''MUST''']] behave as if the following algorithm    exception if the
1108  is performed:    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1109  = If the [CODE(DOMi)@en[[[AttributeDefinition]]]]    is read$B!>(Bonly <span class=ed>@@ ref</span>.  Otherwise, it
1110  object is read-only, then throw an    <em class=rfc2119>MUST</em> set the specified value as the value
1111  [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].    associated to this attribute.</p>
1112  = Remove any child node the node has.  
1113  = If the new value is not empty and not [CODE(IDL)@en[[[null]]]],    <p>If the <code>AttributeDefinition</code> node is created during the process
1114  then create a [CODE(DOMi)@en[[[Text]]]] node    to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, an
1115  whose [CODE(DOMa)@en[[[data]]]] is the new value    appropriate value from the
1116  and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].    <a href="#DeclaredValueType"><code>DeclaredValueType</code></a> constant
1117  </pre>    group <em class=rfc2119>MUST</em> be set to the attribute.</p>
1118    
1119      <!-- DeclaredValueType -->
1120  <p>The definition group  <p>The definition group
1121  <dfn id=DeclaredValueType><code>DeclaredValueType</code></dfn> contains  <dfn id=DeclaredValueType><code>DeclaredValueType</code></dfn> contains
1122  integers indicating the declared type of attributes.</p>  integers indicating the declared type of attributes.  The definition
1123    group contains the following constants:</p>
1124    
1125  <table>  <table>
1126  <thead>  <thead>
# Line 712  set to <a href="#NO_TYPE_ATTR"><code>NO_ Line 1183  set to <a href="#NO_TYPE_ATTR"><code>NO_
1183  </div>  </div>
1184    
1185  <p>If the source of the information does not distinguish <q>no value</q>  <p>If the source of the information does not distinguish <q>no value</q>
1186  and/or <code>unknown</code> <span class=ed>[INFOSET]</span> and  and/or <q>unknown</q> <span class=ed>[INFOSET]</span> and
1187  <code>CDATA</code> <span class=ed>[XML]</span>, then the value  <code>CDATA</code> <span class=ed>[XML]</span>, then the value
1188  <a href="#CDATA_ATTR"><code>CDATA_ATTR</code></a> <em class=rfc2119>MUST</em>  <a href="#CDATA_ATTR"><code>CDATA_ATTR</code></a> <em class=rfc2119>MUST</em>
1189  be used.</p>  be used.</p>
# Line 720  be used.</p> Line 1191  be used.</p>
1191  <p>In Perl binding <span class=ed>[PERLBINDING]</span>, the  <p>In Perl binding <span class=ed>[PERLBINDING]</span>, the
1192  <code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the  <code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the
1193  <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>  <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>
1194  constant group.</p>  definition group.</p>
1195    
1196  <pre class=ed>    </dd>
1197  [7] The  <dt><dfn id=defaultType class=dom-attr><code>defaultType</code></dfn> of
1198  [DFN@en[definition group [CODE(DOM)@en[[[DefaultValueType]]]]]]  type <code>unsigned short</code></dt>
1199  contains integers indicating the type of    <dd><p>The type of the default for the attribute.  It is expected that this
1200  default attribute value:    attribute contains a value from the definition group
1201  ,[CODE(DOMc)@en[[[UNKNOWN_DEFAULT]]]],[CODE(IDL)[[[0]]]],The default value is unknown.    <a href="#DefaultValueType"><code>DefaultValueType</code></a>.</p>
1202  ,[CODE(DOMc)@en[[[FIXED_DEFAULT]]]],[CODE(IDL)[[[1]]]],The default value is provided and the attribute is [CODE(XML)@en[#[[FIXED]]]] to that value.  
1203  ,[CODE(DOMc)@en[[[REQUIRED_DEFAULT]]]],[CODE(IDL)[[[2]]]],An attribute specification is [CODE(XML)@en[#[[REQUIRED]]]] for the attribute.    <p>On getting, the attribute <em class=rfc2119>MUST</em> return
1204  ,[CODE(DOMc)@en[[[IMPLIED_DEFAULT]]]],[CODE(IDL)[[[3]]]],The default value is [CODE(XML)@en[#[[IMPLIED]]]].    the value associated to this attribute.</p>
1205  ,[CODE(DOMc)@en[[[EXPLICIT_DEFAULT]]]],[CODE(IDL)[[[4]]]],The default value is provided but the attribute is not fixed to it.  
1206      <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1207  The type of these constants are    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
1208  [CODE(IDL)@en[[[unsigned]] [[short]]]].    exception if the
1209      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1210  If the source of the attribute default value type    is read$B!>(Bonly <span class=ed>@@ ref</span>.  Otherwise, it
1211  does not distinguish the [CODE(XML)@en[#[[IMPLIED]]]]    <em class=rfc2119>MUST</em> set the specified value as the value
1212  default and unknown default, then the    associated to this attribute.</p>
1213  [CODE(DOMc)@en[[[IMPLIED_DEFAULT]]]] value  
1214  [['''MUST''']] be used.    <p>If the
1215      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node is
1216  ;; A newly created [CODE(DOMi)@en[[[AttributeDefinition]]]]    created during the process to create a <abbr>DOM</abbr> from an
1217  object by [CODE(DOMm)@en[[[createAttributeDefinition]]]]    <abbr>XML</abbr> document, an appropriate value from the
1218  method has [CODE(DOMa)@en[[[declaredType]]]] attribute    <a href="#DefaultValueType"><code>DefaultValueType</code></a> definition
1219  set to [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].    group <em class=rfc2119>MUST</em> be set to the attribute.</p>
1220    
1221  ** Tree-relationship Attributes    <!-- DefaultValueType -->
1222      <p>The definition group
1223  [10]    <dfn id=DefaultValueType><code>DefaultValueType</code></dfn>
1224  The    contains integers indicating the type of the default for the attribute.
1225  [DFN@en[[CODE(DOMa)@en[[[ownerElementTypeDefinition]]]] attribute]]    The definition group contains the following constans:</p>
1226  of the [CODE(DOMi)@en[[[AttributeDefinition]]]] interface  
1227  is read-only and of type    <table>
1228  [CODE(DOMi)@en[[[ElementTypeDefinition]]]].    <thead>
1229  It is the [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node    <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
1230  which the [CODE(DOMi)@en[[[AttributeDefinition]]]] node    </thead>
1231  belong to.    <tbody>
1232      <tr>
1233  If the [CODE(DOMi)@en[[[AttributeDefinition]]]] node    <th scope=row><dfn id=UNKNOWN_DEFAULT class=dom-const><code>UNKNOWN_DEFAULT</code></dfn>
1234  is included in the [CODE(DOMa)@en[[[attributeDefinitions]]]]    <td><code>0</code><td>Unknown.</tr>
1235  list of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node,    <tr>
1236  then the attribute [['''MUST''']] return the    <th scope=row><dfn id=FIXED_DEFAULT class=dom-const><code>FIXED_DEFAULT</code></dfn>
1237  [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node.    <td><code>1</code><td>Provided explicitly and fixed
1238  Otherwise, it [['''MUST''']] return [CODE(DOM)@en[[[null]]]].    <span class=ed>@@ ref</span> to that value.</tr>
1239      <tr>
1240  ;; This attribute is analogue to the    <th scope=row><dfn id=REQUIRED_DEFAULT class=dom-const><code>REQUIRED_DEFAULT</code></dfn>
1241  [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute    <td><code>2</code><td>No default value and the attribute have to be
1242  for [CODE(DOMi)@en[[[ElementTypeDefinition]]]],    explicitly specified.</tr>
1243  [CODE(DOMi)@en[[[Entity]]]], and [CODE(DOMi)@en[[[Notation]]]]    <tr>
1244  nodes, or the [CODE(DOMa)@en[[[ownerElement]]]]    <th scope=row><dfn id=IMPLIED_DEFAULT class=dom-const><code>IMPLIED_DEFAULT</code></dfn>
1245  attribute for [CODE(DOMi)@en[[[Attr]]]] nodes.    <td><code>3</code><td>Implied <span class=ed>@@ ref</span>.</tr>
1246      <tr>
1247  ** Attributes    <th scope=row><dfn id=EXPLICIT_DEFAULT class=dom-const><code>EXPLICIT_DEFAULT</code></dfn>
1248      <td><code>4</code><td>Provided explicitly.</tr>
1249  [5]    </tbody>
1250  The [DFN@en[[CODE(DOMa)@en[[[declaredType]]]] attribute]]    </table>
1251  of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  
1252  represents the type of the attribute value.    <p>If the source of the default type does not distinguish
1253      implied and unknown default types, then the value
1254  This attribute is read-write.    <a href="#IMPLIED_DEFAULT"><code>IMPLIED_DEFAULT</code></a>
1255  The type of the attribute is    <em class=rfc2119>MUST</em> be used.</p>
1256  [CODE(IDL)@en[[[unsigned]] [[short]]]].  It is expected  
1257  that this attribute has a value from the definition group    <div class="note memo">
1258  [CODE(DOM)@en[[[DeclaredValueType]]]].    <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1259      node created by the
1260  The getter [['''MUST''']] return a value associated    <a href="#createAttributeDefinition"><code>createAttributeDefinition</code></a>
1261  to this attribute.    method has its <a href="#defaultType"><code>defaultType</code></a>
1262      attribute set to
1263  The setter [['''MUST''']]    <a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</p>
1264  throw a [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]]    </div></dd>
1265  [CODE(DOMi)@en[[[DOMException]]]] if the  </dl>
 [CODE(DOMi)@en[[[AttributeDefinition]]]] object is read-only.  
 Otherwise, the setter [['''MUST''']] set the specified  
 value as the value associated to this attribute.  
   
 If a parser create an [CODE(DOMi)@en[[[AttributeDefinition]]]]  
 object, then it [['''MUST''']] set a value  
 from the [CODE(DOM)@en[[[DeclaredValueType]]]]  
 definition group.  
   
 [8]  
 The [DFN@en[[CODE(DOMa)@en[[[defaultType]]]] attribute]]  
 of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  
 represents the type of the attribute default value.  
   
 This attribute is read-write.  
 The type of the attribute is  
 [CODE(IDL)@en[[[unsigned]] [[short]]]].  It is expected  
 that this attribute has a value from the definition group  
 [CODE(DOM)@en[[[DefaultValueType]]]].  
   
 The getter [['''MUST''']] return a value associated  
 to this attribute.  
   
 The setter [['''MUST''']]  
 throw a [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]]  
 [CODE(DOMi)@en[[[DOMException]]]] if the  
 [CODE(DOMi)@en[[[AttributeDefinition]]]] object is read-only.  
 Otherwise, the setter [['''MUST''']] set the specified  
 value as the value associated to this attribute.  
   
 If a parser create an [CODE(DOMi)@en[[[AttributeDefinition]]]]  
 object, then it [['''MUST''']] set a value  
 from the [CODE(DOM)@en[[[DefaultValueType]]]]  
 definition group.</pre>  
 </div>  
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>
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.9  
changed lines
  Added in v.1.20
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24