/[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.4 by wakaba, Sun Dec 2 05:00:26 2007 UTC revision 1.16 by wakaba, Tue Dec 4 10:44:09 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-03>3 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  </div>  </div>
133    
134  <div class=section id=dom-dtdef>  <div class=section id=dom-dtdef>
# Line 139  consists of three interfaces:</p> Line 143  consists of three interfaces:</p>
143  <li><a href="#AttributeDefinition"><code>AttributeDefinition</code></a></li>  <li><a href="#AttributeDefinition"><code>AttributeDefinition</code></a></li>
144  </ul>  </ul>
145    
146  <p>In addition, it adds methods, attributes, and/or constants to interfaces  <p>In addition, it modifies interfaces
147  <a href="#Node"><code>Node</code></a>,  <a href="#Node"><code>Node</code></a>,
148    <a href="#DocumentType"><code>DocumentType</code></a>,
149  <a href="#Entity"><code>Entity</code></a>,  <a href="#Entity"><code>Entity</code></a>,
150  <a href="#EntityReference"><code>EntityReference</code></a>, and  <a href="#EntityReference"><code>EntityReference</code></a>,
151  <a href="#Notation"><code>Notation</code></a>.  <a href="#Notation"><code>Notation</code></a>, and
152  It modifies semantics of some of methods and attributes in  <a href="#ProcessingInstruction"><code>ProcessingInstruction</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>  
153    
154  <div class=section id=features>  <div class=section id=features>
155  <h3>Feature Name</h3>  <h3>Feature Name</h3>
# Line 172  feature names with or without version nu Line 174  feature names with or without version nu
174  aforementioned cases.</p>  aforementioned cases.</p>
175  </div>  </div>
176    
177    <div class=section id=section-node>
178    <h3>Modifications to the <code id=Node>Node</code> Interface</h3>
179    
180    <p>The implementation of the
181    <a href="#Node"><code>Node</code></a> interface
182    <em class=rfc2119>MUST</em> be modified as following:</p>
183    <pre class=idl><code>// Additions to the Node interface
184    
185    // Additions to the NodeType definition group
186    const unsigned short <a href="#ELEMENT_TYPE_DEFINITION_NODE">ELEMENT_TYPE_DEFINITION_NODE</a> = 81001;
187    const unsigned short <a href="#ATTRIBUTE_DEFINITION_NODE">ATTRIBUTE_DEFINITION_NODE</a> = 81002;
188    </pre>
189    
190    <p>This specification adds two new types (subinterfaces) of
191    <a href="#Node"><code>Node</code></a>: element type definition (node type
192    <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>,
193    interface
194    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) and
195    attribute definition (node type
196    <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>,
197    interface
198    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>).  For
199    these kinds of nodes, methods and attributes in the
200    <a href="#Node"><code>Node</code></a> interface must behave as following:</p>
201    
202    <dl>
203    <dt><code id=attributes>attributes</code></dt>
204      <dd>
205        <p>On getting, the attribute <em class=rfc2119>MUST</em> return
206        <code>null</code>.</p>
207      </dd>
208    <dt><code id=baseURI>baseURI</code></dt>
209      <dd>
210        <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
211        value of the <a href="#baseURI"><code>baseURI</code></a> attribute
212        of the node in the <code>ownerDocument</code> attribute of the node.
213        Note that the value might be <code>null</code>.</p>
214      </dd>
215    <dt><code id=nodeName>nodeName</code></dt>
216      <dd>
217        <p>If the node is an
218        <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
219        On getting, the attribute <em class=rfc2119>MUST</em> return the
220        name of the element type definition represented by the node.</p>
221    
222        <p>If the node is an
223        <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:
224        On getting, the attribute <em class=rfc2119>MUST</em> return the
225        name of the attribute definition represented by the node.</p>
226      </dd>
227    <dt><code id=nodeType>nodeType</code></dt>
228      <dd>
229        <p>On getting, the attribute <em class=rfc2119>MUST</em> return
230        <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>
231        (if the node is an
232        <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) or
233        <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>
234        (if the node is an
235        <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>).</p>
236    
237        <!-- NodeType -->
238    <p>Two constants are added to the <code id=NodeType>NodeType</code>
239    definition group of the <a href="#Node"><code>Node</code></a> interface as
240    following:</p>
241    <table>
242    <thead>
243    <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
244    </thead>
245    <tbody>
246    <tr>
247    <th scope=row><dfn id=ELEMENT_TYPE_DEFINITION_NODE class=dom-const><code>ELEMENT_TYPE_DEFINITION_NODE</code></dfn>
248    <td><code>81001</code><td>The node is an
249    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>.</tr>
250    <tr>
251    <th scope=row><dfn id=ATTRIBUTE_DEFINITION_NODE class=dom-const><code>ATTRIBUTE_DEFINITION_NODE</code></dfn>
252    <td><code>81002</code><td>The node is an
253    <a href="#ElementTypeDefinition"><code>AttributeDefinition</code></a>.</tr>
254    </tbody>
255    </table>
256      </dd>
257    <dt><code id=nodeValue>nodeValue</code> and
258    <code id=textContent>textContent</code></dt>
259      <dd>
260        <p>If the node is an
261        <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
262        On getting, the attributes <em class=rfc2119>MUST</em> return the
263        name of the element type.</p>
264    
265        <div class="note memo">
266          <p>Thus, on setting the attributes does nothing
267          <span class=ed>[DOM3]</span>.</p>
268        </div>
269    
270        <p>On setting, the <a href="#textContent"><code>textContent</code></a>
271        attribute <em class=rfc2119>MUST NOT</em> raise a
272        <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>.
273        <span class=ed>@@ I forgot why this requirement is necessary.</span></p>
274    
275        <p>If the node is an
276        <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:</p>
277    
278        <pre class=ed>
279    The getter of the [CODE(DOMa)@en[[[nodeValue]]]] attribute
280    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
281    [['''MUST''']] return the normalized default value
282    of the attribute.
283    
284    @@
285    
286    [4] The getter of the [CODE(DOMa)@en[[[textContent]]]]
287    attribute of an [CODE(DOMi)@en[[[AttributeDefinition]]]]
288    object [['''MUST''']] behave as if it were an
289    [CODE(DOMi)@en[[[Attr]]]] object.
290    
291    The setter of the [CODE(DOMa)@en[[[textContent]]]] attribute
292    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
293    [['''MUST''']] behave as if the following algorithm
294    is performed:
295    = If the [CODE(DOMi)@en[[[AttributeDefinition]]]]
296    object is read-only, then throw an
297    [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].
298    = Remove any child node the node has.
299    = If the new value is not empty and not [CODE(IDL)@en[[[null]]]],
300    then create a [CODE(DOMi)@en[[[Text]]]] node
301    whose [CODE(DOMa)@en[[[data]]]] is the new value
302    and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].
303    </pre>
304      </dd>
305    <dt class=ed>@@ ...</dt>
306    </dl>
307    
308    </div>
309    
310  <div class=section id=section-documentxdoctype>  <div class=section id=section-documentxdoctype>
311  <h2>The <code>DocumentXDoctype</code> Interface</h2>  <h3>The <code>DocumentXDoctype</code> Interface</h3>
312    
313    <p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface
314    <em class=rfc2119>MUST</em> be implemented as following:</p>
315  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {
316        DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>
317        (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)
318        raises (DOMException);
319      <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#createElementTypeDefinition">createElementTypeDefinition</a>
320        (in DOMString <a href="#createElementTypeDefinition-name"><var>name</var></a>)
321        raises (DOMException);
322      <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#createAttributeDefinition">createAttributeDefinition</a>
323        (in DOMString <a href="#createAttributeDefinition-name"><var>name</var></a>)
324        raises (DOMException);
325      <a href="#Entity">Entity</a> <a href="#createGeneralEntity">createGeneralEntityDefinition</a>
326        (in DOMString <a href="#createGeneralEntity-name"><var>name</var></a>)
327        raises (DOMException);
328      <a href="#Notation">Notation</a> <a href="#createNotation">createNotation</a>
329        (in DOMString <a href="#createNotation-name"><var>name</var></a>)
330        raises (DOMException);
331  }</code></pre>  }</code></pre>
332    
333  <pre class=ed>  <div class=ed>@@ cast definition</div>
 * The [CODE(DOMi)@en[DocumentXDoctype]] Interface Specification  
334    
335  [1] [[manakai//DOM Extensions]] > New Interfaces >  <dl>
336  [[DOM XML Document Type Definition]] module >  <dt><dfn id=createDocumentTypeDefinition class=dom-method><code>createDocumentTypeDefinition</code></dfn>,
337  The [CODE(DOMi)@en[[[DocumentXDoctype]]]] Interface  method</dt>
338      <dd>
339  [2]      <p>This method creates a <code>DocumentType</code> node with the specified
340  @@ cast      name, belonging to the document.</p>
341        <p>The <dfn id=createDocumentTypeDefinition-name class=dom-param><var>name</var></dfn>
342  ** Constructors      parameter is the name of the document type.</p>
343    
344  [3] The      <p>When invoked, the method <em class=rfc2119>MUST</em> create and
345  [DFN@en[[CODE(DOMm)@en[[[createDocumentTypeDefinition]]]] method]]      return a <code>DocumentType</code> node with the following attributes:</p>
346  returns a [CODE(DOMi)@en[[[DocumentType]]]] node      <dl>
347  or raises a [CODE(DOMi)@en[[[DOMException]]]].      <dt><code>attributes</code>, <code>parentNode</code></dt>
348  It creates a [CODE(DOMi)@en[[[DocumentType]]]] node        <dd><code>null</code>.</dd>
349  of the given name, belonging to the document.      <dt><code>elementTypes</code>, <code>generalEntities</code>, and
350        <code>notations</code></dt>
351  [3] The        <dd>Empty <code>NamedNodeMap</code> objects.</dd>
352  [DFN@en[[CODE(DOMm)@en[[[createElementTypeDefinition]]]] method]]      <dt><code>entities</code></dt>
353  returns an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node        <dd>The same value as the <code>generalEntities</code> attribute.</dd>
354  or raises a [CODE(DOMi)@en[[[DOMException]]]].      <dt><code>childNodes</code></dt>
355  It creates an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node        <dd>An empty <code>NodeList</code> object.</dd>
356  of the given name, belonging to the document.      <dt><code>internalSubset</code>, <code>publicId</code>, and
357        <code>systemId</code></dt>
358  [4] The        <dd>Empty strings.</dd>
359  [DFN@en[[CODE(DOMm)@en[[[createAttributeDefinition]]]] method]]      <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
360  returns an [CODE(DOMi)@en[[[AttributeDefinition]]]] node        <dd><code>false</code>.</dd>
361  or raises a [CODE(DOMi)@en[[[DOMException]]]].      <dt><code>nodeName</code></dt>
362  It creates an [CODE(DOMi)@en[[[AttributeDefinition]]]] node        <dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd>
363  of the given name, belonging to the document.      <dt><code>ownerDocument</code></dt>
364          <dd>The <code>Document</code> over which the method is invoked.</dd>
365  [10] The      </dl>
366  [DFN@en[[CODE(DOMm)@en[[[createGeneralEntity]]]] method]]      <p>In addition, the method <em class=rfc2119>MUST</em> be marked as
367  returns an [CODE(DOMi)@en[[[Entity]]]] node      containing five general entity declarations: <code>amp</code>,
368  or raises a [CODE(DOMi)@en[[[DOMException]]]].      <code>lt</code>, <code>gt</code>, <code>quot</code>, and
369  It creates an [CODE(DOMi)@en[[[Entity]]]] node,      <code>apos</code>.</p>
370  which represents a general entity,    </dd>
371  of the given name, belonging to the document.  <dt><dfn id=createElementTypeDefinition class=dom-method><code>createElementTypeDefinition</code></dfn>,
372    method</dt>
373  [12] The    <dd>
374  [DFN@en[[CODE(DOMm)@en[[[createNotation]]]] method]]      <p>This method creates a <code>ElementTypeDefinition</code> node with the
375  returns a [CODE(DOMi)@en[[[Notation]]]] node      specified name, belonging to the document.</p>
376  or raises a [CODE(DOMi)@en[[[DOMException]]]].      <p>The <dfn id=createElementTypeDefinition-name class=dom-param><var>name</var></dfn>
377  It creates a [CODE(DOMi)@en[[[Notation]]]] node      parameter is the name of the element type defined by the element
378  of the given name, belonging to the document.      type definition.</p>
379    
380  [5]      <p>When invoked, the method <em class=rfc2119>MUST</em> create and
381  These method take a parameter [CODE(DOMp)@en[[[name]]]],      return an
382  of type [CODE(DOMi)@en[[[DOMString]]]].  It is      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
383  the document type name, element type name,      node with the following attributes:</p>
384  or attribute name of the node to be created.      <dl>
385        <dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt>
386  [6]        <dd>An empty <code>NamedNodeMap</code> object.</dd>
387  The [CODE(DOMm)@en[[[createDocumentTypeDefinition]]]]      <dt><code>attributes</code>, <code>parentNode</code></dt>
388  method [['''MUST''']] create a [CODE(DOMi)@en[[[DocumentType]]]]        <dd><code>null</code>.</dd>
389  object with the following attribute values:      <dt><code>childNodes</code></dt>
390  - [CODE(DOMa)@en[[[attributes]]]],        <dd>An empty <code>NodeList</code> object.</dd>
391  [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].      <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
392  - [CODE(DOMa)@en[[[elementTypes]]]],        <dd><code>false</code>.</dd>
393  [CODE(DOMa)@en[[[generalEntities]]]],      <dt><code>nodeName</code></dt>
394  [CODE(DOMa)@en[[[notations]]]]: Empty        <dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd>
395  [CODE(DOMi)@en[[[NamedNodeMap]]]]s.      <dt><code>ownerDocument</code></dt>
396  - [CODE(DOMa)@en[[[childNodes]]]]: An empty        <dd>The <code>Document</code> node over which the method is invoked.</dd>
397  [CODE(DOMi)@en[[[NodeList]]]].      <dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a></dt>
398  - [CODE(DOMa)@en[[[entities]]]]: The same        <dd><code>null</code>.</dd>
399  [CODE(DOMi)@en[[[NamedNodeMap]]]] as      <dt class=ed>@@ Ensure all attributes are defined</dt>
400  [CODE(DOMa)@en[[[generalEntities]]]].      </dl>
401  - [CODE(DOMa)@en[[[internalSubset]]]],    </dd>
402  [CODE(DOMa)@en[[[publicId]]]], [CODE(DOMa)@en[[[systemId]]]]:  <dt><dfn id=createAttributeDefinition class=dom-method><code>createAttributeDefinition</code></dfn>,
403  Empty strings.  method</dt>
404  - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:    <dd>
405  [CODE(IDL)@en[[[false]]]].      <p>This method creates a <code>AttributeDefinition</code> node with the
406  - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].      specified name, belonging to the document.</p>
407  - [CODE(DOMa)@en[[[ownerDocument]]]]: The      <p>The <dfn id=createAttributeDefinition-name class=dom-param><var>name</var></dfn>
408  [CODE(DOMi)@en[[[Document]]]] node on which the method      parameter is the name of the attribute defined by the attribute
409  is invoked.      definition.</p>
410    
411  In addition, it [['''MUST''']] be marked as containing      <p>When invoked, the method <em class=rfc2119>MUST</em> create and
412  five general entity declarations for XML predefined      return an
413  entities, i.e. [CODE(XML)@en[[[amp]]]], [CODE(XML)@en[[[lt]]]],      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
414  [CODE(XML)@en[[[gt]]]], [CODE(XML)@en[[[quot]]]], and      node with the following attributes:</p>
415  [CODE(XML)@en[[[apos]]]].      <dl>
416        <dt><code>allowedTokens</code></dt>
417  [8]        <dd>An empty <code>DOMStringList</code> object.</dd>
418  The [CODE(DOMm)@en[[[createElementTypeDefinition]]]]      <dt><code>attributes</code>,
419  method [['''MUST''']] create an      <a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a>,
420  [CODE(DOMi)@en[[[ElementTypeDefinition]]]]      and <code>parentNode</code></dt>
421  object with the following attribute values:        <dd><code>null</code>.</dd>
422  - [CODE(DOMa)@en[[[attributeDefinitions]]]]:      <dt><code>childNodes</code></dt>
423  An empty [CODE(DOMi)@en[[[NamedNodeMap]]]].        <dd>An empty <code>NodeList</code> object.</dd>
424  - [CODE(DOMa)@en[[[attributes]]]],      <dt><code>declaredType</code></dt>
425  [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].        <dd><a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</dd>
426  - [CODE(DOMa)@en[[[childNodes]]]]: An empty      <dt><code>defaultType</code></dt>
427  [CODE(DOMi)@en[[[NodeList]]]].        <dd><a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</dd>
428  - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:      <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
429  [CODE(IDL)@en[[[false]]]].        <dd><code>false</code>.</dd>
430  - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].      <dt><code>nodeName</code></dt>
431  - [CODE(DOMa)@en[[[ownerDocument]]]]: The        <dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd>
432  [CODE(DOMi)@en[[[Document]]]] node on which the method      <dt><code>ownerDocument</code></dt>
433  is invoked.        <dd>The <code>Document</code> node over which the method is invoked.</dd>
434  - [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]]:      <dt class=ed>@@ Ensure all attributes are defined</dt>
435  [CODE(IDL)@en[[[null]]]].      </dl>
436    
437  @@ Ensure all attributes are defined      <div class=ed>
438        <p>@@ Should we keep these statements?:
439  [9] The [CODE(DOMm)@en[[[createAttributeDefinition]]]]  However, if the &lt;cfg::cfg|xml-id> configuration
440  method [['''MUST''']] create an  parameter is set to <code>true</code> and the <var>name</var>
441  [CODE(DOMi)@en[[[AttributeDefinition]]]]  is <code>xml:id</code>, then the [CODE(DOMa)@en[[[declaredType]]]]
442  object with the following attribute values:  attribute is set to <code>ID_ATTR</code>.
443  - [CODE(DOMa)@en[[[allowedTokens]]]]:  [CODE(DOMa)@en[[[defaultType]]]]?</p>
444  An empty [CODE(DOMi)@en[[[DOMStringList]]]].      </div>
445  - [CODE(DOMa)@en[[[attributes]]]],    </dd>
446  [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].  <dt><dfn id=createGeneralEntity class=dom-method><code>createGeneralEntity</code></dfn>,
447  - [CODE(DOMa)@en[[[childNodes]]]]: An empty  method</dt>
448  [CODE(DOMi)@en[[[NodeList]]]].    <dd>
449  - [CODE(DOMa)@en[[[declaredType]]]]:      <p>This method creates a <a href="#Entity"><code>Entity</code></a> node
450  [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].      with the specified name, which represents a general entity, belonging to
451  - [CODE(DOMa)@en[[[defaultType]]]]:      the document.</p>
452  [CODE(DOMc)@en[[[UNKNOWN_DEFAULT]]]].      <p>The <dfn id=createGeneralEntity-name class=dom-param><var>name</var></dfn>
453  - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:      parameter is the name of the general entity.</p>
454  [CODE(IDL)@en[[[false]]]].  
455  - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].      <p>When invoked, the method <em class=rfc2119>MUST</em> create and return
456  - [CODE(DOMa)@en[[[ownerDocument]]]]: The      an <a href="#Entity"><code>Entity</code></a> node with the following
457  [CODE(DOMi)@en[[[Document]]]] node on which the method      attributes:</p>
458  is invoked.      <dl>
459  - [CODE(DOMa)@en[[[ownerElementTypeDefinition]]]]:      <dt><code>attributes</code>, <code>notationName</code>,
460  [CODE(IDL)@en[[[null]]]].      <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,
461        and <code>parentNode</code></dt>
462  @@ Ensure all attributes are defined        <dd><code>null</code>.</dd>
463        <dt><code>childNodes</code></dt>
464  @@ Should we keep these statements?:        <dd>An empty <code>NodeList</code> object.</dd>
465  However, if the <cfg::cfg|xml-id> configuration      <dt><code>manakaiDeclarationBaseURI</code>,
466  parameter is set to <DOM::true> and the <P::name>      <code>manakaiEntityBaseURI</code>, and
467  is <XA::xml:id>, then the [CODE(DOMa)@en[[[declaredType]]]]      <code>manakaiEntityURI</code> <span class=ed>@@ ref</span></dt>
468  attribute is set to        <dd>No explicit value is set.</dd>
469  <C::AttributeDefinition.ID_ATTR>.      <dt><code>manakaiHasReplacementTree</code> and
470  [CODE(DOMa)@en[[[defaultType]]]]?      <code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
471          <dd><code>false</code>.</dd>
472  [11] The [CODE(DOMm)@en[[[createGeneralEntity]]]]      <dt><code>nodeName</code></dt>
473  method [['''MUST''']] create an [CODE(DOMi)@en[[[Entity]]]]        <dd><a href="#createGeneralEntity-name"><var>name</var></a>.</dd>
474  node with the following attribute values:        <dd>
475  - [CODE(DOMa)@en[[[attributes]]]],          <div class="note memo">
476  [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].            <p>It is not an error for
477  - [CODE(DOMa)@en[[[childNodes]]]]: An empty            <a href="#createGeneralEntity-name"><var>name</var></a> matching
478  [CODE(DOMi)@en[[[NodeList]]]].            to the name of one of predefined general parsed entities in
479  - [CODE(DOMa)@en[[[manakaiDeclarationBaseURI]]]]:            <abbr>XML</abbr> or <abbr>HTML</abbr>.  For example,
480  No explicit value is set.            <a href="#createGeneralEntity-name"><var>name</var></a> might be
481  - [CODE(DOMa)@en[[[manakaiEntityBaseURI]]]]:            <code>amp</code>, resulting in an
482  No explicit value is set.            <a href="#Entity"><code>Entity</code></a> node
483  - [CODE(DOMa)@en[[[manakaiEntityURI]]]]:            with its <code>nodeName</code> attribute set to <code>amp</code>.</p>
484  No explicit value is set.          </div>
485  - [CODE(DOMa)@en[[[manakaiHasReplacementTree]]]]:        </dd>
486  [CODE(IDL)@en[[[false]]]].      <dt><code>ownerDocument</code></dt>
487  - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:        <dd>The <code>Document</code> node over which the method is invoked.</dd>
488  [CODE(IDL)@en[[[false]]]].      <dt><code>publicId</code>, and <code>systemId</code></dt>
489  - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].        <dd><code>null</code>.</dd>
490  - [CODE(DOMa)@en[[[notationName]]]]: [CODE(DOM)@en[[[null]]]].        <dd class=ed>@@ publicId and systemId should be empty string?</dd>
491  - [CODE(DOMa)@en[[[ownerDocument]]]]: The      <dt class=ed>@@ Ensure all attributes are defined</dd>
492  [CODE(DOMi)@en[[[Document]]]] node on which the method      </dl>
493  is invoked.    </dd>
494  - [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]]:  <dt><dfn id=createNotation class=dom-method><code>createNotation</code></dfn>,
495  [CODE(IDL)@en[[[null]]]].  method</dt>
496  - [CODE(DOMa)@en[[[publicId]]]]: [CODE(DOM)@en[[[null]]]].    <dd>
497  - [CODE(DOMa)@en[[[systemId]]]]: [CODE(DOM)@en[[[null]]]].      <p>This method creates a <code>Notation</code> node with the
498        specified name, belonging to the document.</p>
499  @@ Ensure all attributes are defined      <p>The <dfn id=createNotation-name class=dom-param><var>name</var></dfn>
500        parameter is the name of the notation.</p>
501  @@ publicId and systemId should be empty string?  
502        <p>When invoked, the method <em class=rfc2119>MUST</em> create and return
503  [13] The [CODE(DOMm)@en[[[createNotation]]]]      a <code>Notation</code> node with the following attributes:</p>
504  method [['''MUST''']] create a [CODE(DOMi)@en[[[Notation]]]]      <dl>
505  node with the following attribute values:      <dt><code>attributes</code>,
506  - [CODE(DOMa)@en[[[attributes]]]],      <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,
507  [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].      and <code>parentNode</code></dt>
508  - [CODE(DOMa)@en[[[childNodes]]]]: An empty        <dd><code>null</code>.</dd>
509  [CODE(DOMi)@en[[[NodeList]]]].      <dt><code>childNodes</code></dt>
510  - [CODE(DOMa)@en[[[manakaiDeclarationBaseURI]]]]:        <dd>An empty <code>NodeList</code> object.</dd>
511  No explicit value is set.      <dt><code>manakaiDeclarationBaseURI</code></dt>
512  - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:        <dd>No explicit value is set.</dd>
513  [CODE(IDL)@en[[[false]]]].      <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
514  - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].        <dd><code>false</code>.</dd>
515  - [CODE(DOMa)@en[[[ownerDocument]]]]: The      <dt><code>nodeName</code></dt>
516  [CODE(DOMi)@en[[[Document]]]] node on which the method        <dd><a href="#createNotation-name"><var>name</var></a>.</dd>
517  is invoked.      <dt><code>ownerDocument</code></dt>
518  - [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]]:        <dd>The <code>Document</code> node over which the method is invoked.</dd>
519  [CODE(IDL)@en[[[null]]]].      <dt><code>publicId</code> and <code>systemId</code></dt>
520  - [CODE(DOMa)@en[[[publicId]]]]: [CODE(DOM)@en[[[null]]]].        <dd><code>null</code>.</dd>
521  - [CODE(DOMa)@en[[[systemId]]]]: [CODE(DOM)@en[[[null]]]].        <dd class=ed>@@ publicId and systemId should be empty string?</dd>
522        <dt class=ed>@@ Ensure all attributes are defined</dt>
523  @@ Ensure all attributes are defined      </dl>
524      </dd>
525  [7]  </dl>
 These method [['''MUST''']] raise an  
 [CODE(DOMi)@en[[[INVALID_CHARACTER_ERR]]]]  
 [CODE(DOMi)@en[[[DOMException]]]]  
 if the [CODE(DOMp)@en[[[name]]]] is not a legal  
 name according to the XML version in use as  
 specified in the [CODE(DOMa)@en[[[xmlVersion]]]]  
 attribute of the [CODE(DOMi)@en[[[Document]]]] node.  
   
 ;; Non-XML case is intentionally left unspecified for now  
 since DOM3 does not define it.  
   
 ;; [CODE(DOMp)@en[[[name]]]] does not have to  
 be a namespace qualified name.  
   
 ;; Note also that it is not an error for the  
 [CODE(DOMp)@en[[[name]]]] parameter value  
 to match to the name of one of predefined general  
 parsed entities in XML or HTML.  
   
 ;; If the [CODE(DOMa)@en[[[strictErrorChecking]]]] attribute  
 is set to [CODE(IDL)@en[[[false]]]], then the implementation  
 is not required to raise this exception.  
526    
527  Otherwise, these method [['''MUST''']] return  <p>These methods <em class=rfc2119>MUST</em> raise an
528  the newly created node.  <code>INVALID_CHARACTER_ERR</code> exception <span class=ed>@@ ref</span>
529  </pre>  if <var>name</var> is <em>not</em> a legal <code>Name</code> according to
530    the <abbr>XML</abbr> version in use, as specified in the
531    <code>xmlVersion</code> attribute of the <code>Document</code> node.</p>
532    
533    <div class="note memo">
534    <p>Non$B!>(B<abbr>XML</abbr> case is intentionally left unspecified for now,
535    since <abbr>DOM3</abbr> specification <span class=ed>@@ ref</span> does not
536    define it for <code>Document</code> methods.</p>
537    
538    <p><var>name</var> does not have to be a namespace qualified name.</p>
539    </div>
540    
541    </div>
542    
543    
544    <div class=section id=section-documenttype>
545    <h3>Modifications to the <code id=DocumentType>DocumentType</code>
546    Interface</h3>
547    
548    <p>A <a href="#DocumentType"><code>DocumentType</code></a> interface
549    <em class=rfc2119>MAY</em> contain zero or more
550    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
551    nodes in the <code>NodeList</code> object contained in the
552    <code>childNodes</code> attribute of the
553    <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
554    
555    <p>If the <a href="#DocumentType"><code>DocumentType</code></a> node is created
556    during the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr>
557    document, the <code>NodeList</code> object in the <code>childNodes</code>
558    object <em class=rfc2119>MUST</em> contains the
559    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
560    nodes representing the processing instructions in the document type
561    definition of the document processed <span class=ed>@@ ref</span> by
562    the <abbr>XML</abbr> processor.  If the
563    <a href="#DocumentType"><code>DocumentType</code></a> node is marked
564    as read$B!>(Bonly, then all the child nodes <em class=rfc2119>MUST</em>
565    also be marked as read$B!>(Bonly.</p>
566    
567    <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is created
568    from a document type declaration information item <span class=ed>@@ ref</span>,
569    the <code>NodeList</code> object in the <code>childNodes</code> attribute
570    of the node <em class=rfc2119>MUST</em> contain the
571    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes
572    created from the processing instruction information items in the list in the
573    [children] property of the document type declaration item in the same
574    order.</p>
575    
576    <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is mapped to
577    a document type declaration information item, the list in the [children]
578    property <em class=rfc2119>MUST</em> contain the processng instruction
579    information items created from the
580    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes
581    in the <code>NodeList</code> object in the <code>childNodes</code> attribute
582    of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
583    
584    <p>The implementation of the
585    <a href="#DocumentType"><code>DocumentType</code></a> interface
586    <em class=rfc2119>MUST</em> be modified as following:</p>
587    <pre class=idl><code>// Modifications to the DocumentType interface
588      attribute DOMString <a href="#publicId">publicId</a>;
589      attribute DOMString <a href="#systemId">systemId</a>;
590    
591      attribute DOMString <a href="#internalSubset">internalSubset</a>;
592    </code></pre>
593    
594    <p>The <code id=publicId>publicId</code> attribute and the
595    <code id=systemId>systemId</code> attribute of
596    <a href="#DocumentType"><code>DocumentType</code></a>,
597    <a href="#Entity"><code>Entity</code></a>, and
598    <a href="#Notation"><code>Notation</code></a> interfaces are no longer
599    read$B!>(Bonly.</p>
600    
601    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
602    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
603    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.  
604    Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value
605    associated to the attribute.  No normalization, relative reference resolution,
606    or lexical validation is performed. <span class=ed>@@ If the new
607    value is <code>null</code>, ...</span></p>
608    
609    <div class="note memo">
610    <p>Setting an invalid identifier might make the node unserializable.
611    Setting a public identifier while leaveing system identifier unspecified
612    would also make the <a href="#DocumentType"><code>DocumentType</code></a>
613    or <a href="#Entity"><code>Entity</code></a> node unserializable.</p>
614    </div>
615    
616    <div class=ed>
617    <p>ISSUE: In HTML5, Firefox 1.5, and Opera 9, not specifying public or system identifier results in empty strings.</p>
618    </div>
619    
620    <p>The <code id=internalSubset>internalSubset</code> attribute of the
621    <a href="#DocumentType"><code>DocumentType</code></a> interface is no longer
622    read$B!>(Bonly.</p>
623    
624    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
625    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
626    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.  
627    Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value
628    associated to the attribute.  No normalization, or lexical validation is
629    performed. <span class=ed>@@ If the new value is <code>null</code>,
630    ...</span></p>
631    
632  </div>  </div>
633    
634  <div class=section id=section-documenttypedefinition>  <div class=section id=section-documenttypedefinition>
635  <h2>The <code>DocumentTypeDefinition</code> Interface</h2>  <h3>The <code>DocumentTypeDefinition</code> Interface</h3>
636    
637    <p>The
638    <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
639    interface <em class=rfc2119>MUST</em> be implemented as following:</p>
640  <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {  <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {
641        readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>;
642      readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>;
643      readonly attribute NamedNodeMap <a href="#notations">notations</a>;
644    
645      <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#getElementTypeDefinitionNode">getElementTypeDefinitionNode</a>
646        (in DOMString <a href="#getElementTypeDefinitionNode-name"><var>name</var></a>);
647      <a href="#Entity">Entity</a> <a href="#getGeneralEntityNode">getGeneralEntityNode</a>
648        (in DOMString <a href="#getGeneralEntityNode-name"><var>name</var></a>);
649      <a href="#Notation">Notation</a> <a href="#getNotationNode">getNotationNode</a>
650        (in DOMString <a href="#getNotationNode-name"><var>name</var></a>);
651    
652      void <a href="#setElementTypeDefinitionNode">setElementTypeDefinitionNode</a>
653        (in DOMString <a href="#setElementTypeDefinitionNode-node"><var>node</var></a>)
654        raises (DOMException);
655      void <a href="#setGeneralEntityNode">setGeneralEntityNode</a>
656        (in DOMString <a href="#setGeneralEntityNode-node"><var>node</var></a>)
657        raises (DOMException);
658      void <a href="#setNotationNode">setNotationNode</a>
659        (in DOMString <a href="#setNotationNode-node"><var>node</var></a>)
660        raises (DOMException);
661  }</code></pre>  }</code></pre>
662    
663  <pre class=ed>  <pre class=ed>
# Line 416  feature, a [CODE(DOMi)@en[[[DocumentType Line 667  feature, a [CODE(DOMi)@en[[[DocumentType
667  must implement the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]  must implement the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]
668  interface.  See [[DOM XML Document Type Definition]>>3] for  interface.  See [[DOM XML Document Type Definition]>>3] for
669  details.  details.
670    </pre>
671    
672    <dl>
673  ** Children  <dt><dfn id=elementTypes class=dom-attr><code>elementTypes</code></dfn> of
674    type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
675  [2] The [DFN@en[[CODE(DOMa)@en[[[elementTypes]]]] attribute]]    <dd><p>A live <code>NamedNodeMap</code> object that contains all the element
676  of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface    type definitions belonging to the <code>DocumentType</code> node.</p>
677  is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that  
678  contains all element types belongs to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
679  node.  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].    <code>NamedNodeMap</code> object that contains all the
680  The attribute is read-only.    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
681      nodes belonging to the <code>DocumentType</code> node.  The
682  What are contained in this collection depends on how    <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be read$B!>(Bonly
683  the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node was created.  If the    if and only if the node is read$B!>(Bonly.  The <code>NamedNodeMap</code>
684  node was created as the result of parsing of an XML document,    object <em class=rfc2119>MUST</em> be live and the same object
685  it [['''MUST''']]  contain all element types whose element type and / or    <em class=rfc2119>MUST</em> be returned for any invocation.</p>
686  attribute definition list declaration are encountered by and provided for the DOM  
687  implementation from the XML processor.  Note that the XML processor might not    <p>If the <code>DocumentType</code> node is created during the process
688  provide a part of or entire such information depending on the configuration.    to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, the following
689  If more than one declarations for an element type or an attribute is available    requirements are applied:  The <code>NamedNodeMap</code> object in the
690  at the time of the definition node construction, then declarations other than    <a href="#elementTypes"><code>elementType</code></a> attribute
691  the first ones [['''MUST''']] be discarded.    <em class=rfc2119>MUST</em> be so transformed that the object contains
692      the <code>ElementTypeDefinition</code> nodes for the element types
693  The attribute [['''MUST''']] return the [CODE(DOMi)@en[[[NamedNodeMap]]]]    whose name is presented as the <code>Name</code> of the element type or
694  object that contains all the [CODE(DOMi)@en[[[ElementTypeDefinition]]]] nodes    attribute definition list declarations processed by the <abbr>XML</abbr>
695  belong to the node.  The returned [CODE(DOMi)@en[[[NamedNodeMap]]]] object    processor.  If there is more than one element type declarations for an
696  [['''MUST''']] be read-only if and only if the node is read-only.    element type, then the declarations other than the first one
697  Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live    <em class=rfc2119>MUST</em> be ignored for the purpose of constructing the
698  and therefore any change of read-only flag on the node is immediately    <code>NamedNodeMap</code> object.</p></dd>
699  reflected by that of the object.  <dt><dfn id=generalEntities class=dom-attr><code>generalEntities</code></dfn>
700    of type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
701  [3] The [DFN@en[[CODE(DOMa)@en[[[generalEntities]]]] attribute]]    <dd><p>A live <code>NamedNodeMap</code> object that contains all the general
702  of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface    entities belonging to the <code>DocumentType</code> node.</p>
703  is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that contains all the    
704  general entities belong to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node.    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
705  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].    same value as the <code>entities</code> attribute (defined in the
706  The attribute is read-only.    <code>DocumentType</code> interface) of the same node.</p>
707    
708      <div class="note memo">
709        <p>This attribute is part of the interface for historical reason.</p>
710      </div></dd>
711    <!--
712  All entities declared in the document type definition  All entities declared in the document type definition
713  contained in or referenced from the document entity  contained in or referenced from the document entity
714  might not be exposed through this collection, depending  might not be exposed through this collection, depending
# Line 472  representing general entities belong to Line 728  representing general entities belong to
728  the node is read-only. Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live  the node is read-only. Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live
729  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
730  reflected by that of the object.  reflected by that of the object.
731    -->
732  The attribute [['''MUST''']] return the same value as the  <dt><dfn id=notations class=dom-attr><code>notations</code></dfn> of type
733  [CODE(DOMa)@en[[[entites]]]] attribute of the  <code>notations</code>, read$B!>(Bonly</code>
734  [CODE(DOMi)@en[[[DocumentType]]]] interface on the same node.    <dd><p>A live <code>NamedNodeMap</code> object that contains all the
735      notations belonging to the <code>DocumentType</code> node.</p>
736  [4] The [DFN@en[[CODE(DOMa)@en[[[notations]]]] attribute]]    
737  of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
738  is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that contains    same value as the <code>notations</code> attribute (defined in the
739  all the notations belong to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]    <code>DocumentType</code> interface) of the same node.</p>
740  node.  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].  
741  The attribute is read-only.    <div class="note memo">
742        <p>This attribute is part of the interface for historical reason.</p>
743        <p>Implementations are not required to implement the
744        <code>notations</code> attribute twice (for <code>DocumentType</code>
745        and <code>DocumentTypeDefinition</code> interfaces); they share exactly
746        same definition.</p>
747      </div></dd>
748    <!--
749  If the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node is  If the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node is
750  created from an XML document, duplicate notation declarations, if any, in DTD  created from an XML document, duplicate notation declarations, if any, in DTD
751  [['''MUST NOT''']] result in a node in the [CODE(DOMi)@en[[[NamedNodeMap]]]]  [['''MUST NOT''']] result in a node in the [CODE(DOMi)@en[[[NamedNodeMap]]]]
# Line 507  representing notations belong to the nod Line 769  representing notations belong to the nod
769  the node is read-only. Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live  the node is read-only. Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live
770  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
771  reflected by that of the object.  reflected by that of the object.
772    -->
773    
774  A DOM implementation is not required to implement the  <dt class=ed>@@ other members...
775  [CODE(DOMa)@en[[[notations]]]] attribute twice  </dl>
 for the [CODE(DOMi)@en[[[DocumentType]]]] and  
 the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interfaces;  
 the latter is defined to contain the same value as the former.  
776    
777    <div class=ed>
778    <p>A future version of this interface might define the
779    <code>parameterEntities</code> and getter/setter for parameter entities.
780    </div>
781    
 ** Open Issues (informative)  
   
 [5] A future version of the interface might define the  
 [CODE(DOMa)@en[[[parameterEntities]]]] attribute and  
 getter/setter for parameter entities.  
 </pre>  
782  </div>  </div>
783    
784  <div class=section id=section-elementtypedefinition>  <div class=section id=section-elementtypedefinition>
785  <h2>The <code>ElementTypeDefinition</code> Interface</h2>  <h3>The <code>ElementTypeDefinition</code> Interface</h3>
   
 <pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> {  
     
 }</code></pre>  
786    
787  <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members  <p>The <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
788    interface <em class=rfc2119>MUST</em> be implemented as following:</p>
789    <pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> : <a href="#Node">Node</a> {
790      readonly attribute <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
791    
792  [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute    <span class=ed>@@ more</span>
793  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]]]].  
   
 ** The [CODE(DOMi)@en[ElementTypeDefinition]] Interface  
794    
795  [5] The  <pre class=ed>
796  [DFN@en[[CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute]]  [DFN@en[[CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute]]
797  of the [CODE(DOMi)@en[[[ElementTypeDefinition]]]]  of the [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
798  interface is defined in [[manakai//DOM Extensions]>>50].</pre>  interface is defined in [[manakai//DOM Extensions]>>50].</pre>
799  </div>  </div>
800    
801  <div class=section id=section-attributedefinition>  <div class=section id=section-attributedefinition>
802  <h2>The <code>AttributeDefinition</code> Interface</h2>  <h3>The <code>AttributeDefinition</code> Interface</h3>
803    
804  <pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> {  <p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
805    interface <em class=rfc2119>MUST</em> be implemented as following:</p>
806    <pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> : <a href="#Node">Node</a> {
807      <span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span>
808      const unsigned short <a href="#NO_TYPE_ATTR">NO_TYPE_ATTR</a> = 0;
809      const unsigned short <a href="#CDATA_ATTR">CDATA_ATTR</a> = 1;
810      const unsigned short <a href="#ID_ATTR">ID_ATTR</a> = 2;
811      const unsigned short <a href="#IDREF_ATTR">IDREF_ATTR</a> = 3;
812      const unsigned short <a href="#IDREFS_ATTR">IDREFS_ATTR</a> = 4;
813      const unsigned short <a href="#ENTITY_ATTR">ENTITY_ATTR</a> = 5;
814      const unsigned short <a href="#ENTITIES_ATTR">ENTITIES_ATTR</a> = 6;
815      const unsigned short <a href="#NMTOKEN_ATTR">NMTOKEN_ATTR</a> = 7;
816      const unsigned short <a href="#NMTOKENS_ATTR">NMTOKENS_ATTR</a> = 8;
817      const unsigned short <a href="#NOTATION_ATTR">NOTATION_ATTR</a> = 9;
818      const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10;
819      const unsigned short <a href="#UNKNOWN_ATTR">UNKNOWN_ATTR</a> = 11;
820        
821  }</code></pre>    readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;
   
 <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members  
822    
823  [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute    readonly attribute unsigned short <a href="#declaredType">declaredType</a>;
824  of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object    readonly attribute unsigned short <a href="#defaultType">defaultType</a>;
 [['''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]]]].  
825    
826  [1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute    <span class=ed>...</span>
827  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.  
   
 @@  
   
 [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]]]].  
828    
829  ** Definition groups  <dl>
830    <dt><dfn id=ownerElementTypeDefinition class=dom-attr><code>ownerElementTypeDefinition</code></dfn>
831    of type
832    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
833    read$B!>(Bonly</dt>
834      <dd><p>The
835      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> to
836      which the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
837      node belongs.</p>
838    
839      <p>On getting, the attribute <em class=rfc2119>MUST</em> return an
840      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.
841      It <em class=rfc2119>MUST</em> be such a node that whose
842      <a href="#attributeDefinitons"><code>attributeDefinitions</code></a>
843      attribute contains the <code>NamedNodeMap</code> object that contains
844      the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
845      node.  If there is no such an
846      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node,
847      then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p>
848    <dt><dfn id=declaredType class=dom-attr><code>declaredType</code></dfn> of type
849    <code>unsigned short</code></dt>
850      <dd><p>The declared type <span class=ed>@@ ref</span> of the attribute.
851      It is expected that this attribute contains a value from the definition group
852      <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>.</p>
853    
854      <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
855      value associated to this attribute.</p>
856    
857      <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
858      <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
859      exception if the
860      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
861      is read$B!>(Bonly <span class=ed>@@ ref</span>.  Otherwise, it
862      <em class=rfc2119>MUST</em> set the specified value as the value
863      associated to this attribute.</p>
864    
865      <p>If the <code>AttributeDefinition</code> node is created during the process
866      to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, an
867      appropriate value from the
868      <a href="#DeclaredValueType"><code>DeclaredValueType</code></a> constant
869      group <em class=rfc2119>MUST</em> be set to the attribute.</p>
870    
871      <!-- DeclaredValueType -->
872    <p>The definition group
873    <dfn id=DeclaredValueType><code>DeclaredValueType</code></dfn> contains
874    integers indicating the declared type of attributes.  The definition
875    group contains the following constants:</p>
876    
877    <table>
878    <thead>
879    <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
880    </thead>
881    <tbody>
882    <tr>
883    <th scope=row><dfn id=NO_TYPE_ATTR class=dom-const><code>NO_TYPE_ATTR</code>
884    <td><code>0</code><td>No value <span class=ed>[INFOSET]</span>.</tr>
885    <tr>
886    <th scope=row><dfn id=CDATA_ATTR class=dom-const><code>CDATA_ATTR</code>
887    <td><code>1</code><td><code>CDATA</code> <span class=ed>[XML]</span>.</tr>
888    <tr>
889    <th scope=row><dfn id=ID_ATTR class=dom-const><code>ID_ATTR</code>
890    <td><code>2</code><td><code>ID</code> <span class=ed>[XML]</span>.</tr>
891    <tr>
892    <th scope=row><dfn id=IDREF_ATTR class=dom-const><code>IDREF_ATTR</code>
893    <td><code>3</code><td><code>IDREF</code> <span class=ed>[XML]</span>.</tr>
894    <tr>
895    <th scope=row><dfn id=IDREFS_ATTR class=dom-const><code>IDREFS_ATTR</code>
896    <td><code>4</code><td><code>IDREFS</code> <span class=ed>[XML]</span>.</tr>
897    <tr>
898    <th scope=row><dfn id=ENTITY_ATTR class=dom-const><code>ENTITY_ATTR</code>
899    <td><code>5</code><td><code>ENTITY</code> <span class=ed>[XML]</span>.</tr>
900    <tr>
901    <th scope=row><dfn id=ENTITIES_ATTR class=dom-const><code>ENTITIES_ATTR</code>
902    <td><code>6</code><td><code>ENTITIES</code> <span class=ed>[XML]</span>.</tr>
903    <tr>
904    <th scope=row><dfn id=NMTOKEN_ATTR class=dom-const><code>NMTOKEN_ATTR</code>
905    <td><code>7</code><td><code>NMTOKEN</code> <span class=ed>[XML]</span>.</tr>
906    <tr>
907    <th scope=row><dfn id=NMTOKENS_ATTR class=dom-const><code>NMTOKENS_ATTR</code>
908    <td><code>8</code><td><code>NMTOKENS</code> <span class=ed>[XML]</span>.</tr>
909    <tr>
910    <th scope=row><dfn id=NOTATION_ATTR class=dom-const><code>NOTATION_ATTR</code>
911    <td><code>9</code><td><code>NOTATION</code> <span class=ed>[XML]</span>.</tr>
912    <tr>
913    <th scope=row><dfn id=ENUMERATION_ATTR class=dom-const><code>ENUMERATION_ATTR</code>
914    <td><code>10</code><td>Enumeration <span class=ed>[XML]</span>.</tr>
915    <tr>
916    <th scope=row><dfn id=UNKNOWN_ATTR class=dom-const><code>UNKNOWN_ATTR</code>
917    <td><code>11</code><td>Unknown, because no declaration for the attribute
918    has been read but the [all declaration processed] property
919    <span class=ed>[INFOSET]</span> would be false.</tr>
920    </tbody>
921    </table>
922    
923    <p>If no attribute type information is available, or if the source
924    of the information does not distinguish <q>no value</q> and <q>unknown</q>
925    <span class=ed>[INFOSET]</span>, then the value
926    <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>
927    <em class=rfc2119>MUST</em> be used.</p>
928    
929    <div class="note memo">
930    <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
931    created by the
932    <a href="#createAttributeDefinition"><code>createAttributeDefinition</code></a>
933    method has its <a href="#declaredType"><code>declaredType</code></a> attribute
934    set to <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</p>
935    </div>
936    
937    <p>If the source of the information does not distinguish <q>no value</q>
938    and/or <q>unknown</q> <span class=ed>[INFOSET]</span> and
939    <code>CDATA</code> <span class=ed>[XML]</span>, then the value
940    <a href="#CDATA_ATTR"><code>CDATA_ATTR</code></a> <em class=rfc2119>MUST</em>
941    be used.</p>
942    
943    <p>In Perl binding <span class=ed>[PERLBINDING]</span>, the
944    <code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the
945    <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>
946    definition group.</p>
947    
948      </dd>
949    <dt><dfn id=defaultType class=dom-attr><code>defaultType</code></dfn> of
950    type <code>unsigned short</code></dt>
951      <dd><p>The type of the default for the attribute.  It is expected that this
952      attribute contains a value from the definition group
953      <a href="#DefaultValueType"><code>DefaultValueType</code></a>.</p>
954    
955      <p>On getting, the attribute <em class=rfc2119>MUST</em> return
956      the value associated to this attribute.</p>
957    
958      <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
959      <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
960      exception if the
961      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
962      is read$B!>(Bonly <span class=ed>@@ ref</span>.  Otherwise, it
963      <em class=rfc2119>MUST</em> set the specified value as the value
964      associated to this attribute.</p>
965    
966      <p>If the
967      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node is
968      created during the process to create a <abbr>DOM</abbr> from an
969      <abbr>XML</abbr> document, an appropriate value from the
970      <a href="#DefaultValueType"><code>DefaultValueType</code></a> definition
971      group <em class=rfc2119>MUST</em> be set to the attribute.</p>
972    
973      <!-- DefaultValueType -->
974      <p>The definition group
975      <dfn id=DefaultValueType><code>DefaultValueType</code></dfn>
976      contains integers indicating the type of the default for the attribute.
977      The definition group contains the following constans:</p>
978    
979      <table>
980      <thead>
981      <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
982      </thead>
983      <tbody>
984      <tr>
985      <th scope=row><dfn id=UNKNOWN_DEFAULT class=dom-const><code>UNKNOWN_DEFAULT</code></dfn>
986      <td><code>0</code><td>Unknown.</tr>
987      <tr>
988      <th scope=row><dfn id=FIXED_DEFAULT class=dom-const><code>FIXED_DEFAULT</code></dfn>
989      <td><code>1</code><td>Provided explicitly and fixed
990      <span class=ed>@@ ref</span> to that value.</tr>
991      <tr>
992      <th scope=row><dfn id=REQUIRED_DEFAULT class=dom-const><code>REQUIRED_DEFAULT</code></dfn>
993      <td><code>2</code><td>No default value and the attribute have to be
994      explicitly specified.</tr>
995      <tr>
996      <th scope=row><dfn id=IMPLIED_DEFAULT class=dom-const><code>IMPLIED_DEFAULT</code></dfn>
997      <td><code>3</code><td>Implied <span class=ed>@@ ref</span>.</tr>
998      <tr>
999      <th scope=row><dfn id=EXPLICIT_DEFAULT class=dom-const><code>EXPLICIT_DEFAULT</code></dfn>
1000      <td><code>4</code><td>Provided explicitly.</tr>
1001      </tbody>
1002      </table>
1003    
1004      <p>If the source of the default type does not distinguish
1005      implied and unknown default types, then the value
1006      <a href="#IMPLIED_DEFAULT"><code>IMPLIED_DEFAULT</code></a>
1007      <em class=rfc2119>MUST</em> be used.</p>
1008    
1009      <div class="note memo">
1010      <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1011      node created by the
1012      <a href="#createAttributeDefinition"><code>createAttributeDefinition</code></a>
1013      method has its <a href="#defaultType"><code>defaultType</code></a>
1014      attribute set to
1015      <a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</p>
1016      </div></dd>
1017    </dl>
1018    
 [6] The  
 [DFN@en[definition group [CODE(DOM)@en[[[DeclaredValueType]]]]]]  
 contains integers indicating the type of  
 attribute value:  
 ,[CODE(DOMc)@en[[[NO_TYPE_ATTR]]]],[CODE(IDL)[[[0]]]],The attribute value type corresponding to [[no value]] in XML Information Set.  
 ,[CODE(DOMc)@en[[[CDATA_ATTR]]]],[CODE(IDL)[[[1]]]],The attribute value type is [CODE(XML)@en[[[CDATA]]]].  
 ,[CODE(DOMc)@en[[[ID_ATTR]]]],[CODE(IDL)[[[2]]]],The attribute value type is [CODE(XML)@en[[[ID]]]].  
 ,[CODE(DOMc)@en[[[IDREF_ATTR]]]],[CODE(IDL)[[[3]]]],The attribute value type is [CODE(XML)@en[[[IDREF]]]].  
 ,[CODE(DOMc)@en[[[IDREFS_ATTR]]]],[CODE(IDL)[[[4]]]],The attribute value type is [CODE(XML)@en[[[IDREFS]]]].  
 ,[CODE(DOMc)@en[[[ENTITY_ATTR]]]],[CODE(IDL)[[[5]]]],The attribute value type is [CODE(XML)@en[[[ENTITY]]]].  
 ,[CODE(DOMc)@en[[[ENTITIES_ATTR]]]],[CODE(IDL)[[[6]]]],The attribute value type is [CODE(XML)@en[[[ENTITIES]]]].  
 ,[CODE(DOMc)@en[[[NMTOKEN_ATTR]]]],[CODE(IDL)[[[7]]]],The attribute value type is [CODE(XML)@en[[[NMTOKEN]]]].  
 ,[CODE(DOMc)@en[[[NMTOKENS_ATTR]]]],[CODE(IDL)[[[8]]]],The attribute value type is [CODE(XML)@en[[[NMTOKENS]]]].  
 ,[CODE(DOMc)@en[[[NOTATION_ATTR]]]],[CODE(IDL)[[[9]]]],The attribute value type is [CODE(XML)@en[[[NOTATION]]]].  
 ,[CODE(DOMc)@en[[[ENUMERATION_ATTR]]]],[CODE(IDL)[[[10]]]],The attribute value is enumeration type.  
 ,[CODE(DOMc)@en[[[UNKNOWN_ATTR]]]],[CODE(IDL)[[[11]]]],"The attribute value type is unknown, because no declaration for the attribute has been read but not [CODE(InfoProp)@en[[[all declarations processed]]]] property would be false."  
   
 The type of these constants are  
 [CODE(IDL)@en[[[unsigned]] [[short]]]].  
   
 If no attribute type information is provided,  
 or if the source of that information does not  
 distinguish [[no value]] and [[unknown]] as in  
 XML Information Set, then the  
 [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]] value  
 [['''MUST''']] be used.  
   
 ;; A newly created [CODE(DOMi)@en[[[AttributeDefinition]]]]  
 object by [CODE(DOMm)@en[[[createAttributeDefinition]]]]  
 method has [CODE(DOMa)@en[[[declaredType]]]] attribute  
 set to [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].  
   
 If the source of the attribute type information  
 does not distinguish [[no value]] and / or [[unknown]]  
 and [CODE(XML)@en[[[CDATA]]]], then the  
 [CODE(DOMc)@en[[[CDATA_ATTR]]]] value [['''MUST''']]  
 be used.  
   
 [11]  
 In Perl binding, the objects implementing the  
 [CODE(DOMi)@en[[[Attr]]]] interface [['''MUST''']]  
 also implement the [CODE(DOM)@en[[[DeclaredValueType]]]]  
 constant group.  
   
 [7] The  
 [DFN@en[definition group [CODE(DOM)@en[[[DefaultValueType]]]]]]  
 contains integers indicating the type of  
 default attribute value:  
 ,[CODE(DOMc)@en[[[UNKNOWN_DEFAULT]]]],[CODE(IDL)[[[0]]]],The default value is unknown.  
 ,[CODE(DOMc)@en[[[FIXED_DEFAULT]]]],[CODE(IDL)[[[1]]]],The default value is provided and the attribute is [CODE(XML)@en[#[[FIXED]]]] to that value.  
 ,[CODE(DOMc)@en[[[REQUIRED_DEFAULT]]]],[CODE(IDL)[[[2]]]],An attribute specification is [CODE(XML)@en[#[[REQUIRED]]]] for the attribute.  
 ,[CODE(DOMc)@en[[[IMPLIED_DEFAULT]]]],[CODE(IDL)[[[3]]]],The default value is [CODE(XML)@en[#[[IMPLIED]]]].  
 ,[CODE(DOMc)@en[[[EXPLICIT_DEFAULT]]]],[CODE(IDL)[[[4]]]],The default value is provided but the attribute is not fixed to it.  
   
 The type of these constants are  
 [CODE(IDL)@en[[[unsigned]] [[short]]]].  
   
 If the source of the attribute default value type  
 does not distinguish the [CODE(XML)@en[#[[IMPLIED]]]]  
 default and unknown default, then the  
 [CODE(DOMc)@en[[[IMPLIED_DEFAULT]]]] value  
 [['''MUST''']] be used.  
   
 ;; A newly created [CODE(DOMi)@en[[[AttributeDefinition]]]]  
 object by [CODE(DOMm)@en[[[createAttributeDefinition]]]]  
 method has [CODE(DOMa)@en[[[declaredType]]]] attribute  
 set to [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].  
   
 ** Tree-relationship Attributes  
   
 [10]  
 The  
 [DFN@en[[CODE(DOMa)@en[[[ownerElementTypeDefinition]]]] attribute]]  
 of the [CODE(DOMi)@en[[[AttributeDefinition]]]] interface  
 is read-only and of type  
 [CODE(DOMi)@en[[[ElementTypeDefinition]]]].  
 It is the [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node  
 which the [CODE(DOMi)@en[[[AttributeDefinition]]]] node  
 belong to.  
   
 If the [CODE(DOMi)@en[[[AttributeDefinition]]]] node  
 is included in the [CODE(DOMa)@en[[[attributeDefinitions]]]]  
 list of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node,  
 then the attribute [['''MUST''']] return the  
 [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node.  
 Otherwise, it [['''MUST''']] return [CODE(DOM)@en[[[null]]]].  
   
 ;; This attribute is analogue to the  
 [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute  
 for [CODE(DOMi)@en[[[ElementTypeDefinition]]]],  
 [CODE(DOMi)@en[[[Entity]]]], and [CODE(DOMi)@en[[[Notation]]]]  
 nodes, or the [CODE(DOMa)@en[[[ownerElement]]]]  
 attribute for [CODE(DOMi)@en[[[Attr]]]] nodes.  
   
 ** Attributes  
   
 [5]  
 The [DFN@en[[CODE(DOMa)@en[[[declaredType]]]] attribute]]  
 of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  
 represents the type of the attribute 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[[[DeclaredValueType]]]].  
   
 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[[[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>  
1019  </div>  </div>
1020    
1021  </div>  </div>
Legend:
Removed from v.1.4  
changed lines
  Added in v.1.16
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24