/[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.25 by wakaba, Sat Dec 8 13:41:36 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-08>8 December 2007</time></h2>
14    
15  <dl class="versions-uri">  <dl class="versions-uri">
16  <dt>This Version</dt>  <dt>This Version</dt>
# Line 50  available at <code class="URI">&lt;<a Line 50  available at <code class="URI">&lt;<a
50  <div id="abstract" class="section">  <div id="abstract" class="section">
51  <h2>Abstract</h2>  <h2>Abstract</h2>
52    
53  <div class="ed issue">...</div>  <p>The <abbr>DOM</abbr> Document Type Definition module is a set of
54    <abbr>DOM</abbr> interfaces, including both new interfaces and modifications
55    to existing <abbr>DOM</abbr> interfaces, over which <abbr>DOM</abbr>
56    applications are able to access to the definitions of the document type.</p>
57  </div>  </div>
58    
59  <div id="status" class="section">  <div id="status" class="section">
# Line 80  normative version.</p> Line 82  normative version.</p>
82    
83  <p class=section-info>This section is <em>non$B!>(Bnormative</em>.</p>  <p class=section-info>This section is <em>non$B!>(Bnormative</em>.</p>
84    
 <div class="issue ed">  
 <p>This is a work-in-progress specification for DOM Document Type  
 Definition module, as implemented by manakai and  
 <a href="http://suika.fam.cx/gate/2005/sw/DOM%20XML%20Document%20Type%20Definition">partially documented in the SuikaWiki</a>.</p>  
 </div>  
   
85  <p>The <dfn id=term-dom-dtdef><abbr>DOM</abbr> Document Type Definition</dfn>  <p>The <dfn id=term-dom-dtdef><abbr>DOM</abbr> Document Type Definition</dfn>
86  module is a set of <abbr>DOM</abbr> interfaces, including both new  module is a set of <abbr>DOM</abbr> interfaces, including both new
87  interfaces and modifications to existing <abbr>DOM</abbr> interfaces,  interfaces and modifications to existing <abbr>DOM</abbr> interfaces,
88  over which <abbr>DOM</abbr> applications are able to access to the  over which <abbr>DOM</abbr> applications are able to access to the
89  definitions of the document type.</p>  definitions of the document type.</p>
90    
91  <p>Interfaces defined in this specification are partially modeled from  <p>Interfaces defined in this document are partially modeled and inspired by
92  early drafts of <abbr>DOM</abbr> level 1 <span class=ed>@@ ref</span>,  early drafts of <abbr>DOM</abbr> Level 1
93  <abbr>DOM</abbr> Abstract Schema level 3 <span class=ed>@@ ref</span>, and  <cite class="bibref informative">[<a href="#ref-DOM1WD">DOM1WD</a>]</cite>,
94  <abbr>XML</abbr> Schema <abbr>API</abbr>, but are not compatible with  <abbr>DOM</abbr> Level 3 Abstract Schemas <abbr>W3C</abbr> Note
95  any of them as a whole.</p>  <cite class="bibref informative">[<a href="#ref-DOM3AS">DOM3AS</a>]</cite>,
96    and <abbr>XML</abbr> Schema <abbr>API</abbr> specification
97    <cite class="bibref informative">[<a href="#ref-XSAPI">XSAPI</a>]</cite>, but
98    they are not compatible with any of them as a whole.</p>
99  </div>  </div>
100    
101  <div class="section" id="terminology">  <div class="section" id=conformance>
102  <h2>Terminology</h2>  <h2>Conformance Requirements</h2>
103    
104  <p>The key words <q><em class="rfc2119">MUST</em></q>,  <div class=section id=terminology>
105  <q><em class="rfc2119">MUST NOT</em></q>,  <h3>Terminology</h3>
 <q><em class="rfc2119">SHOULD</em></q>,  
 <q><em class="rfc2119">SHOULD NOT</em></q>, and  
 <q><em class=rfc2119>MAY</em></q> in this  
 document are to be interpreted as described in  
 <a href="urn:ietf:rfc:2119"><abbr title="Request for Comments">RFC</abbr>  
 2119</a>  
 <cite class="bibref normative">[<a href="#ref-KEYWORDS">KEYWORDS</a>]</cite>.</p>  
106    
 <!-- Strictly speaking the paragraph below is not part of terminology. -->  
107  <p>All examples and notes in this specification are non$B!>(Bnormative,  <p>All examples and notes in this specification are non$B!>(Bnormative,
108  as are all sections explicitly marked non$B!>(Bnormative.  Everything  as are all sections explicitly marked non$B!>(Bnormative.  Everything
109  else in this specification is normative.</p>  else in this specification is normative.</p>
110    
111  <p><span class=ed>Algorithm is normative but non-normative</span>.  <p>The key words <q><em class="rfc2119">MUST</em></q>,
112  In addition, the order in which <a href="#errors">errors</a> are  <q><em class="rfc2119">MUST NOT</em></q>, and <q><em class=rfc2119>MAY</em></q>
113  raised is undefined.</p>  in this document are to be interpreted as described in
114    <a href="urn:ietf:rfc:2119"><abbr title="Request for Comments">RFC</abbr>
115    2119</a>
116    <cite class="bibref normative">[<a href="#ref-KEYWORDS">KEYWORDS</a>]</cite>.</p>
117    
118  <p class=ed><var>A</var> object is an object implementing <var>A</var>  <p>Conformance requirements phrased as algorithms or specific steps
119  interface.</p>  <em class=rfc2119>MAY</em> be implemented in any manner, so long as the end
120    result is equivalent.  Requirements phrased in the imperative as part of
121    algorithms are to be interpreted with the meaning of the key word used in
122    introducing the algorithm.</p>
123    
124    <p>Sometimes an exception is phrased as being required to be raised.  As
125    specified in the <abbr>DOM</abbr> Core specification
126    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>,
127    when the value of the <code>strictErrorChecking</code> attribute of the
128    <a href="#Document"><code>Document</code></a> node is <code>false</code>,
129    then the exception is not have to be raised.</p>
130    
131    <p>Some conformance requirements are phrased as requirements on interfaces,
132    attributes, methods, or objects.  Such requirements are applied to
133    implementations.</p>
134    
135    <p>The construction <q>a <code><var>Foo</var></code> object</q>, where
136    <code><var>Foo</var></code> is an interface, is used instead of the more
137    accurate <q>an object implementing the interface
138    <code><var>Foo</var></code></q>.</p>
139    
140    <p>The construction <q>raise a <code><var>Bar</var></code></q>, where
141    <code><var>Bar</var></code> is an exception code, is used instead of the more
142    accurate <q>raise an exception implementing the interface
143    <code>DOMException</code>
144    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>
145    with its <code>code</code> attribute set to
146    <code><var>Bar</var></code></q>.</p>
147    
148    <p>The terms
149    <em id=live><a href="http://www.whatwg.org/specs/web-apps/current-work/#live">live</a></em>
150    and <em id=setting>setting</em> and <em id=getting>getting</em> of an attribute
151    is defined in the HTML5 specification
152    <cite class="bibref normative">[<a href="#ref-HTML5">HTML5</a>]</cite>.</p>
153    
154    <p>The term
155    <em id=read-only><a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/glossary.html#dt-readonly-node">read$B!>(Bonly (node)</a></em>
156    is defined in the <abbr>DOM</abbr> Level 3 Core specification
157    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p>
158    
159    <p>The <em id=idl-fragment><abbr>IDL</abbr> fragments</em> in this document are
160    to be interpreted as described in the <cite>Language Bindings for
161    <abbr>DOM</abbr> Specifications</cite> specification
162    <cite class="bibref normative">[<a href="#ref-DOMBIND">DOMBIND</a>]</cite>.</p>
163    
164    <p>Some <abbr>IDL</abbr> fragments are presented as <i>patch</i> to an
165    <abbr>IDL</abbr> fragment defined in another document.  They are to be
166    interpreted as an instance of
167    <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMembers"><code>InterfaceMembers</code></a>
168    <cite class="bibref normative">[<a href="#ref-DOMBIND">DOMBIND</a>]</cite>.
169    If the <abbr>IDL</abbr> fragment to which the <i>patch</i> is applied has any
170    instance of
171    <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a>
172    with same
173    <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#prod-identifier"><code>identifier</code></a>
174    part as that of any instance of
175    <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a>
176    in the <i>patch</i>, then the former instance of
177    <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a>
178    <em class=rfc2119>MUST</em> be ignored.</p>
179    </div>
180    
181  <p class=ed>@@ ref to DOM Binding Spec</p>  <div class=section id=conformance-categories>
182    <h3>Conformance Categories</h3>
183    
184    <p>There are several kinds of products that can be claim to conform to
185    this specification:</p>
186    <dl>
187    <dt id=category-dom-implementation><abbr>DOM</abbr> Implementation</dt>
188      <dd>A <abbr>DOM</abbr> implementation (or just written as
189      <q>implementation</q> in this document) provides a way to access
190      <abbr>DOM</abbr> trees for applications by implementing interfaces defined
191      by this and other documents.  Unless otherwise noted, requirements in this
192      document are applied to <abbr>DOM</abbr> implementations.  To implement
193      all the features in this document, the implementation have to implement
194      some version of <abbr>DOM</abbr> Core (e.g. <abbr>DOM</abbr> Level 3 Core
195      <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>)
196      with one or more language binding (e.g. ECMAScript and Java bindings
197      <cite class="bibref normative">[<a href="#ref-DOMBIND">DOMBIND</a>]</cite>
198      or Perl binding
199      <cite class="bibref normative">[<a href="#ref-DOMPERL">DOMPERL</a>]</cite>).
200      A conforming implementation <em class=rfc2119>MUST</em> also be a
201      <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#dfn-conforming-implementation">conforming
202      implementation</a> of the <abbr>IDL</abbr> fragments in this document, as
203      described in the <cite>Language Bindings for <abbr>DOM</abbr>
204      Specifications</cite> specification
205      <cite class="bibref normative">[<a href="#ref-DOMBIND">DOMBIND</a>]</cite>.</dd>
206    <dt id=category-xml-parser><abbr>XML</abbr> Parser (<abbr>XML</abbr> document
207    to <abbr>DOM</abbr> tree converter)</dt>
208      <dd>A software component that converts
209      <abbr>XML</abbr> 1.0 or 1.1 document
210      <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
211      <a href="#ref-XML11">XML11</a>]</cite> (or fragment thereof) into a
212      <abbr>DOM</abbr> tree (or fragment thereof) in the context of this
213      document.  Note that this document does not define any particular way to
214      parse an <abbr>XML</abbr> document or to construct an <abbr>DOM</abbr>
215      document, but it defines constraints for such processing.</dd>
216    <dt id=category-xml-serializer><abbr>XML</abbr> Serializer (<abbr>DOM</abbr>
217    tree to <abbr>XML</abbr> document converter)</dt>
218      <dd>A software component that converts
219      <abbr>DOM</abbr> tree (or fragment thereof) into an <abbr>XML</abbr> 1.0 or
220      1.1 document (or fragment thereof).  Note that this document does not define
221      any particular way to serialize a <abbr>DOM</abbr> tree, but it defines
222      constraints for such processing.</dd>
223    <dt id=category-infoset-dom><abbr>XML</abbr> Information Set to
224    <abbr>DOM</abbr> Tree Converter</dt>
225      <dd>A software component that converts an <abbr>XML</abbr> information set
226      <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>
227      into a <abbr>DOM</abbr> tree.  Note that this documetn does not define
228      any particular way for the convertion, but it defines constraints for
229      such processing.</dd>
230    <dt id=category-dom-infoset><abbr>DOM</abbr> Tree to <abbr>XML</abbr>
231    Information Set Converter</dt>
232      <dd>A software component that converts a <abbr>DOM</abbr> tree into
233      an <abbr>XML</abbr> information set.  Note that this documetn does not define
234      any particular way for the convertion, but it defines constraints for
235      such processing.</dd>
236    </dl>
237    </div>
238  </div>  </div>
239    
240  <div class=section id=dom-dtdef>  <div class=section id=dom-dtdef>
241  <h2><abbr>DOM</abbr> Document Type Definition Module</h2>  <h2><abbr>DOM</abbr> Document Type Definition Module</h2>
242    
243  <p>The <abbr>DOM</abbr> Document Type Definition module, version 3.0,  <p>The <abbr>DOM</abbr> Document Type Definition module, version 3.0,
244  consists of three interfaces:</p>  introduces four interfaces:
245  <ul>  <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a>,
246  <li><a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a></li>  <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>,
247  <li><a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a></li>  <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
248  <li><a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a></li>  and <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>.
249  <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  
250  <a href="#Node"><code>Node</code></a>,  <a href="#Node"><code>Node</code></a>,
251  <a href="#Entity"><code>Entity</code></a>,  <a href="#Document"><code>Document</code></a>,
252  <a href="#EntityReference"><code>EntityReference</code></a>, and  <a href="#DocumentType"><code>DocumentType</code></a>,
253  <a href="#Notation"><code>Notation</code></a>.  <a href="#Entity"><code>Entity</code></a>, and
254  It modifies semantics of some of methods and attributes in  <a href="#Notation"><code>Notation</code></a>
255  <a href="#Node"><code>Node</code></a> and  <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p>
 <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>  
 interfaces, for the support of new interfaces.</p>  
256    
257  <div class=section id=features>  <div class=section id=features>
258  <h3>Feature Name</h3>  <h3>Feature String</h3>
259    
260  <p>In a <abbr>DOM</abbr> implementation that supports the version 3.0 of  <p>In a <abbr>DOM</abbr> implementation that supports the version 3.0 of
261  the <abbr>DOM</abbr> Document Type Definition module, the  the <abbr>DOM</abbr> Document Type Definition module, the
262  <code>hasFeature</code> method of a <code>DOMImplementation</code> object  <code>hasFeature</code> method of a <code>DOMImplementation</code> object
263    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>
264  <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
265  set to <code>http://suika.fam.cx/www/2006/feature/XDoctype</code> and  set to
266  <code>3.0</code> respectively.</p>  <dfn id=feature-XDoctype><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></dfn>
267    and <dfn id=feature-XDoctype-3.0><code>3.0</code></dfn> respectively.  Any
268    method that takes one or more feature names, with or without version number,
269    such as <code>hasFeature</code> or <code>getFeature</code>,
270    <em class=rfc2119>MUST</em> behave in a manner consistent with it.</p>
271    </div>
272    
273    <div class=section id=section-node>
274    <h3>Modifications to the <code id=Node>Node</code> Interface</h3>
275    
276    <p>The implementation of the
277    <a href="#Node"><code>Node</code></a> interface
278    <em class=rfc2119>MUST</em> be modified as the following
279    <a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p>
280    <pre class=idl><code>// Additions to the Node interface
281    
282    // Additions to the NodeType definition group
283    const unsigned short <a href="#ELEMENT_TYPE_DEFINITION_NODE">ELEMENT_TYPE_DEFINITION_NODE</a> = 81001;
284    const unsigned short <a href="#ATTRIBUTE_DEFINITION_NODE">ATTRIBUTE_DEFINITION_NODE</a> = 81002;
285    </pre>
286    
287    <p>This specification adds two new types (subinterfaces) of
288    <a href="#Node"><code>Node</code></a>: element type definition (node type
289    <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>,
290    interface
291    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) and
292    attribute definition (node type
293    <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>,
294    interface
295    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>).  For
296    these kinds of nodes, methods and attributes in the
297    <a href="#Node"><code>Node</code></a> interface must behave as following:</p>
298    
299    <dl>
300    <dt><code id=attributes>attributes</code>,
301    <code id=localName>localName</code>,
302    <code id=manakaiLocalName>manakaiLocalName</code>
303    <cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite>,
304    <code id=namespaceURI>namespaceURI</code>, and
305    <code id=prefix>prefix</code></dt>
306      <dd>
307        <p>On getting, the attributes <em class=rfc2119>MUST</em> return
308        <code>null</code>.</p>
309      </dd>
310    <dt><code id=baseURI>baseURI</code></dt>
311      <dd>
312        <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
313        value of the <a href="#baseURI"><code>baseURI</code></a> attribute
314        of the node in the <code>ownerDocument</code> attribute of the node.
315        Note that the value might be <code>null</code>.</p>
316      </dd>
317    <dt><code id=cloneNode>cloneNode</code></dt>
318      <dd class=ed>
319        <p>A future version of the specification is expected to define the
320        behavior of the <a href="#cloneNode"><code>cloneNode</code></a> method
321        for those kinds of nodes.  In addition, it might revise behavior of
322        the method for <a href="#Entity"><code>Entity</code></a>,
323        <a href="#Notation"><code>Notation</code></a>, and/or
324        <a href="#DocumentType"><code>DocumentType</code></a> nodes.</p>
325      </dd>
326      <!--
327      <dd class=ed>@@ If Attr and AttributeDefinition is inconsistent, then ...</dd>
328      -->
329    <dt><code id=compareDocumentPosition>compareDocumentPosition</code></dt>
330      <dd class=ed>
331        <p>A future version of the specification is expected to define the
332        behavior of the method
333        for those kinds of nodes.  In addition, it might revise behavior of
334        the method for <a href="#Entity"><code>Entity</code></a>,
335        <a href="#Notation"><code>Notation</code></a>, and/or
336        <a href="#DocumentType"><code>DocumentType</code></a> nodes.</p>
337      </dd>
338    <dt><code id=isDefaultNamespace>isDefaultNamespace</code></dt>
339      <dd><p>When invoked, the method <em class=rfc2119>MUST</em> return
340      <code>false</code>.</p></dd>
341    <dt><code id=isEqualNode>isEqualNode</code></dt>
342      <dd><p>For the <a href="#isEqualNode"><code>isEqualNode</code></a> method,
343      following items are added to the list of conditions for equality:</p>
344    
345      <ul>
346      <li>
347        <p>If the nodes are <a href="#DocumentType"><code>DocumentType</code></a>
348        and at least one of them has the support for the feature
349        <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>:</p>
350        <ul>
351        <li>they are equal according to <abbr>DOM</abbr> Level 3 Core definition
352        <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>,
353        and
354        <li>either:
355          <ul><!--
356          <li>both of them does not support the feature
357          <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>,</li>-->
358          <li>exactly one of them support the feature
359          <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
360          and the <code>length</code> attribute of the <code>NamedNodeMap</code>
361          object in the <a href="#elementTypes"><code>elementTypes</code></a>
362          attribute of it is equal to <code>0</code>, or</li>
363          <li>both of them support the feature
364          <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
365          and the values of the
366          <a href="#elementTypes"><code>elementTypes</code></a> attributes are
367          equal (equality of the
368          <a href="#elementTypes"><code>elementTypes</code></a> attribute is same
369          as that for the <code>attributes</code> attribute).</li>
370          </ul>
371        </li>
372        </ul>
373      </li>
374    
375      <li><p>If the nodes are
376      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
377      the values of the
378      <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
379      attributes are equal (equality of the
380      <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
381      attribute is same as that for the <code>attributes</code> attribute).</p></li>
382    
383      <li><p>If the nodes are
384      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>,
385      the values of the <a href="#declaredType"><code>declaredType</code></a> and
386      the <a href="#defaultType"><code>defaultType</code></a> attributes are
387      equal respectively.</p></li>
388    
389      <li><p>If the nodes are
390      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>,
391      the values of the <code>DOMStringList</code> objects in the
392      <a href="#allowedTokens"><code>allowedTokens</code></a> attributes
393      are equal, i.e. their <code>length</code> attribute values are equal and
394      each string exists in a list is contained in another list (their indeces
395      may be different), with an additional constraint that the number of the
396      items that are equal to a string in a list is equal to the number
397      of the items equal to the string in another list.</p></li>
398      </ul></dd>
399    <dt><code id=lookupNamespaceURI>lookupNamespaceURI</code> and
400    <code id=lookupPrefix>lookupPrefix</code></dt>
401      <dd><p>When invoked, the methods <em class=rfc2119>MUST</em> return
402      <code>null</code>.</p></dd>
403    <dt><code id=nodeName>nodeName</code></dt>
404      <dd>
405        <p>If the node is an
406        <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
407        On getting, the attribute <em class=rfc2119>MUST</em> return the
408        name of the element type definition represented by the node.</p>
409    
410        <p>If the node is an
411        <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:
412        On getting, the attribute <em class=rfc2119>MUST</em> return the
413        name of the attribute definition represented by the node.</p>
414      </dd>
415    <dt><code id=nodeType>nodeType</code></dt>
416      <dd>
417        <p>On getting, the attribute <!--<em class=rfc2119>MUST</em>--> returns
418        <!-- NOTE: No MUST, to avoid circular reference (nodeType==8100[12]
419        is defined that they MUST implement ElementType|AttributeDefinition). -->
420        <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>
421        (if the node is an
422        <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) or
423        <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>
424        (if the node is an
425        <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>).</p>
426    
427        <!-- NodeType -->
428    <p>Two constants are added to the <code id=NodeType>NodeType</code>
429    definition group of the <a href="#Node"><code>Node</code></a> interface as
430    following:</p>
431    <table>
432    <thead>
433    <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
434    </thead>
435    <tbody>
436    <tr>
437    <th scope=row><dfn id=ELEMENT_TYPE_DEFINITION_NODE class=dom-const><code>ELEMENT_TYPE_DEFINITION_NODE</code></dfn>
438    <td><code>81001</code><td>The node is an
439    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>.</tr>
440    <tr>
441    <th scope=row><dfn id=ATTRIBUTE_DEFINITION_NODE class=dom-const><code>ATTRIBUTE_DEFINITION_NODE</code></dfn>
442    <td><code>81002</code><td>The node is an
443    <a href="#ElementTypeDefinition"><code>AttributeDefinition</code></a>.</tr>
444    </tbody>
445    </table>
446      </dd>
447    <dt><code id=nodeValue>nodeValue</code> and
448    <code id=textContent>textContent</code></dt>
449      <dd>
450        <p>If the node is an
451        <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
452        On getting, the attributes <em class=rfc2119>MUST</em> return
453        <code>null</code>.</p>
454    
455      <div class="note memo">
456      <p>Thus, on setting the attributes does nothing
457      <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p>
458      </div>
459    
460      <p>If the node is an
461      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:
462      The attribute <em class=rfc2119>MUST</em> behave as if the node
463      were <code>Attr</code>
464      <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p></dd>
465    <dt><code id=normalize>normalize</code></dt>
466      <dd><p>When a <a href="#DocumentType"><code>DocumentType</code></a> is
467      normalized, any nodes in the <code>NamedNodeMap</code> object in the
468      <a href="#elementTypes"><code>elementTypes</code></a> attribute
469      <em class=rfc2119>MUST</em> be normalized as well.</p>
470    
471      <p>When an
472      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
473      is normalized, any nodes in the <code>NamedNodeMap</code> object in the
474      <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
475      attribute <em class=rfc2119>MUST</em> be normalized as well.</p></dd>
476    </dl>
477    
478    </div>
479    
480    <div class=section id=section-document>
481    <h3>Modifications to the <code id=Document>Document</code> Interface</h3>
482    
483    <!--
484    <p>If an attempt is made to adopt an
485    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> or
486    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node,
487    the <code id=adoptNode>adoptNode</code> method <em class=rfc2119>MUST</em>
488    raise a <code>NOT_SUPPORTED_ERR</code> exception <span class=ed>@@
489    ref</span>.</p>
490    -->
491    
492    <div class=ed>
493    <p>Future version of the specification is expected to define what should
494    be done if <code>adoptNode</code> or <code>importNode</code> method have to
495    adopt or import an
496    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> or
497    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node.
498    In addition it might revise behavior of those methods for
499    <a href="#Entity"><code>Entity</code></a>,
500    <a href="#Notation"><code>Notation</code></a>, and/or
501    <a href="#DocumentType"><code>DocumentType</code></a> nodes.
502    Behavior of <code>normalizeDocument</code> method for these kinds of
503    nodes might also be defined in some day.</p>
504    </div>
505    
 <p>In such an implementation, the <code>getFeature</code> method of a  
 <code>Document</code> object <em class=rfc2119>MUST</em> return the (at least  
 conceptually) same object implementing the  
 <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface when  
 the parameters are set to  
 <code>http://suika.fam.cx/www/2006/feature/XDoctype</code> and  
 <code>3.0</code> respectively.  Likewise, any method that takes one or more  
 feature names with or without version number, including the methods  
 <code>hasFeature</code> and <code>getFeature</code>,  
 <em class=rfc2119>MUST</em> behave in a manner consistent with the  
 aforementioned cases.</p>  
506  </div>  </div>
507    
508  <div class=section id=section-documentxdoctype>  <div class=section id=section-documentxdoctype>
509  <h2>The <code>DocumentXDoctype</code> Interface</h2>  <h3>The <code>DocumentXDoctype</code> Interface</h3>
510    
511    <p>The <a href="#Document"><code>Document</code></a> nodes
512    <em class=rfc2119>MUST</em> also implement the
513    <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface.</p>
514    
515    <p>An instance of the
516    <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a>
517    interface <em class=rfc2119>MUST</em> be able to be obtained by using
518    binding$B!>(Bspecific casting methods on an instance of the
519    <a href="#Document"><code>Document</code></a> interface (if such
520    casting methods are available) or by using the method <code>getFeature</code>
521    with parameter values
522    <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
523    and <a href="#feature-XDoctype-3.0"><code>3.0</code></a> respectively (if the
524    <a href="#Document"><code>Document</code></a> node supports the
525    feature <code>Core</code> version <code>3.0</code>
526    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p>
527    
528    <p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface
529    <em class=rfc2119>MUST</em> be implemented as the following
530    <a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p>
531  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {
532        DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>
533        (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)
534        raises (DOMException);
535      <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#createElementTypeDefinition">createElementTypeDefinition</a>
536        (in DOMString <a href="#createElementTypeDefinition-name"><var>name</var></a>)
537        raises (DOMException);
538      <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#createAttributeDefinition">createAttributeDefinition</a>
539        (in DOMString <a href="#createAttributeDefinition-name"><var>name</var></a>)
540        raises (DOMException);
541      <a href="#Entity">Entity</a> <a href="#createGeneralEntity">createGeneralEntityDefinition</a>
542        (in DOMString <a href="#createGeneralEntity-name"><var>name</var></a>)
543        raises (DOMException);
544      <a href="#Notation">Notation</a> <a href="#createNotation">createNotation</a>
545        (in DOMString <a href="#createNotation-name"><var>name</var></a>)
546        raises (DOMException);
547  }</code></pre>  }</code></pre>
548    
549  <pre class=ed>  <dl>
550  * The [CODE(DOMi)@en[DocumentXDoctype]] Interface Specification  <dt><dfn id=createDocumentTypeDefinition class=dom-method><code>createDocumentTypeDefinition</code></dfn>,
551    method</dt>
552      <dd>
553        <p>This method creates a <code>DocumentType</code> node with the specified
554        name, belonging to the document.</p>
555        <p>The
556        <dfn id=createDocumentTypeDefinition-name class=dom-param><var>name</var></dfn>
557        parameter is the name of the document type.</p>
558    
559        <p>When invoked, the method <em class=rfc2119>MUST</em> create and
560        return a <a href="#DocumentType"><code>DocumentType</code></a> node with
561        the following attributes:</p>
562        <dl>
563        <dt><code>attributes</code>, <code>parentNode</code></dt>
564          <dd><code>null</code>.</dd>
565        <dt><a href="#elementTypes"><code>elementTypes</code></a>,
566        <a href="#entities"><code>entities</code></a>, and
567        <a href="#notations"><code>notations</code></a></dt>
568          <dd>Empty <code>NamedNodeMap</code> objects respectively.</dd>
569        <dt><code>childNodes</code></dt>
570          <dd>An empty <code>NodeList</code> object.</dd>
571        <dt><a href="#internalSubset"><code>internalSubset</code></a>,
572        <a href="#publicId"><code>publicId</code></a>, and
573        <a href="#systemId"><code>systemId</code></a></dt>
574          <dd>Empty strings.</dd>
575        <dt><code>nodeName</code></dt>
576          <dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd>
577        <dt><code>ownerDocument</code></dt>
578          <dd>The <a href="#Document"><code>Document</code></a> node over which the
579          method is invoked.</dd>
580        </dl>
581        <p>The returned node <em class=rfc2119>MUST NOT</em> be marked as
582        <a href="#read-only">read$B!>(Bonly</a>.</p>
583        <p>In addition, the method <em class=rfc2119>MUST</em> be marked as
584        containing five general entity declarations: <code>amp</code>,
585        <code>lt</code>, <code>gt</code>, <code>quot</code>, and
586        <code>apos</code>.</p>
587      </dd>
588    <dt><dfn id=createElementTypeDefinition class=dom-method><code>createElementTypeDefinition</code></dfn>,
589    method</dt>
590      <dd>
591        <p>This method creates a <code>ElementTypeDefinition</code> node with the
592        specified name, belonging to the document.</p>
593        <p>The <dfn id=createElementTypeDefinition-name class=dom-param><var>name</var></dfn>
594        parameter is the name of the element type defined by the element
595        type definition.</p>
596    
597        <p>When invoked, the method <em class=rfc2119>MUST</em> create and
598        return an
599        <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
600        node with the following attributes:</p>
601        <dl>
602        <dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt>
603          <dd>An empty <code>NamedNodeMap</code> object.</dd>
604        <dt><code>childNodes</code></dt>
605          <dd>An empty <code>NodeList</code> object.</dd>
606        <dt><a href="#nodeName"><code>nodeName</code></a></dt>
607          <dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd>
608        <dt><code>ownerDocument</code></dt>
609          <dd>The <code>Document</code> node over which the method is invoked.</dd>
610        <dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
611        and <code>parentNode</code></dt>
612          <dd><code>null</code>.</dd>
613        </dl>
614        <p>The returned node <em class=rfc2119>MUST NOT</em> be marked as
615        <a href="#read-only">read$B!>(Bonly</a>.</p>
616      </dd>
617    <dt><dfn id=createAttributeDefinition class=dom-method><code>createAttributeDefinition</code></dfn>,
618    method</dt>
619      <dd>
620        <p>This method creates a <code>AttributeDefinition</code> node with the
621        specified name, belonging to the document.</p>
622        <p>The <dfn id=createAttributeDefinition-name class=dom-param><var>name</var></dfn>
623        parameter is the name of the attribute defined by the attribute
624        definition.</p>
625    
626        <p>When invoked, the method <em class=rfc2119>MUST</em> create and
627        return an
628        <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
629        node with the following attributes:</p>
630        <dl>
631        <dt><a href="#allowedTokens"><code>allowedTokens</code></a></dt>
632          <dd>An empty <code>DOMStringList</code> object.</dd>
633        <dt><code>childNodes</code></dt>
634          <dd>An empty <code>NodeList</code> object.</dd>
635        <dt><a href="#declaredType"><code>declaredType</code></a></dt>
636          <dd><a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</dd>
637        <dt><a href="#defaultType"><code>defaultType</code></a></dt>
638          <dd><a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</dd>
639        <dt><a href="#nodeName"><code>nodeName</code></a></dt>
640          <dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd>
641        <dt><code>ownerDocument</code></dt>
642          <dd>The <code>Document</code> node over which the method is invoked.</dd>
643        <dt><a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a>
644        and <code>parentNode</code></dt>
645          <dd><code>null</code>.</dd>
646        </dl>
647        <p>The returned node <em class=rfc2119>MUST NOT</em> be marked as
648        <a href="#read-only">read$B!>(Bonly</a>.</p>
649    
650        <!-- This requirement, if not droped, should be part of xml-id spec.
651        <div class=ed>
652        <p>@@ Should we keep these statements?:
653    However, if the &lt;cfg::cfg|xml-id> configuration
654    parameter is set to <code>true</code> and the <var>name</var>
655    is <code>xml:id</code>, then the [CODE(DOMa)@en[[[declaredType]]]]
656    attribute is set to <code>ID_ATTR</code>.
657    [CODE(DOMa)@en[[[defaultType]]]]?</p>
658        </div>-->
659      </dd>
660    <dt><dfn id=createGeneralEntity class=dom-method><code>createGeneralEntity</code></dfn>,
661    method</dt>
662      <dd>
663        <p>This method creates a <a href="#Entity"><code>Entity</code></a> node
664        with the specified name, which represents a general entity, belonging to
665        the document.</p>
666        <p>The <dfn id=createGeneralEntity-name class=dom-param><var>name</var></dfn>
667        parameter is the name of the general entity.</p>
668    
669        <p>When invoked, the method <em class=rfc2119>MUST</em> create and return
670        an <a href="#Entity"><code>Entity</code></a> node with the following
671        attributes:</p>
672        <dl>
673        <dt><code>childNodes</code></dt>
674          <dd>An empty <code>NodeList</code> object.</dd>
675        <dt><code>manakaiDeclarationBaseURI</code>,
676        <code>manakaiEntityBaseURI</code>, and <code>manakaiEntityURI</code>
677        <cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt>
678          <dd>No explicit value is set.</dd>
679        <dt><a href="#hasReplacementTree"><code>hasReplacementTree</code></a></dt>
680          <dd><code>false</code>.</dd>
681        <dt><code>nodeName</code></dt>
682          <dd><a href="#createGeneralEntity-name"><var>name</var></a>.</dd>
683          <dd>
684            <div class="note memo">
685              <p>It is not an error for
686              <a href="#createGeneralEntity-name"><var>name</var></a> matching
687              to the name of one of predefined general parsed entities in
688              <abbr>XML</abbr> or <abbr>HTML</abbr>.  For example,
689              <a href="#createGeneralEntity-name"><var>name</var></a> might be
690              <code>amp</code>, resulting in an
691              <a href="#Entity"><code>Entity</code></a> node
692              with its <code>nodeName</code> attribute set to <code>amp</code>.</p>
693            </div>
694          </dd>
695        <dt><a href="#notationName"><code>notationName</code></a>,
696        <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,
697        and <code>parentNode</code></dt>
698          <dd><code>null</code>.</dd>
699        <dt><code>ownerDocument</code></dt>
700          <dd>The <code>Document</code> node over which the method is invoked.</dd>
701        <dt><a href="#publicId"><code>publicId</code></a> and
702        <a href="#systemId"><code>systemId</code></a></dt>
703          <dd><code>null</code>.</dd>
704          <dd class=ed>@@ publicId and systemId should be empty string?</dd>
705        </dl>
706      <p>The returned node <em class=rfc2119>MUST NOT</em> be marked as
707      <a href="#read-only">read$B!>(Bonly</a>.</p></dd>
708    <dt><dfn id=createNotation class=dom-method><code>createNotation</code></dfn>,
709    method</dt>
710      <dd>
711        <p>This method creates a <code>Notation</code> node with the
712        specified name, belonging to the document.</p>
713        <p>The <dfn id=createNotation-name class=dom-param><var>name</var></dfn>
714        parameter is the name of the notation.</p>
715    
716        <p>When invoked, the method <em class=rfc2119>MUST</em> create and return
717        a <code>Notation</code> node with the following attributes:</p>
718        <dl>
719        <dt><code>childNodes</code></dt>
720          <dd>An empty <code>NodeList</code> object.</dd>
721        <dt><code>manakaiDeclarationBaseURI</code>
722        <cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt>
723          <dd>No explicit value is set.</dd>
724        <dt><code>nodeName</code></dt>
725          <dd><a href="#createNotation-name"><var>name</var></a>.</dd>
726        <dt><code>ownerDocument</code></dt>
727          <dd>The <code>Document</code> node over which the method is invoked.</dd>
728        <dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
729        and <code>parentNode</code></dt>
730          <dd><code>null</code>.</dd>
731        <dt><a href="#publicId"><code>publicId</code></a> and
732        <a href="#systemId"><code>systemId</code></a></dt>
733          <dd><code>null</code>.</dd>
734          <dd class=ed>@@ publicId and systemId should be empty string?</dd>
735        </dl>
736      <p>The returned node <em class=rfc2119>MUST NOT</em> be marked as
737      <a href="#read-only">read$B!>(Bonly</a>.</p></dd>
738    </dl>
739    
740  [1] [[manakai//DOM Extensions]] > New Interfaces >  <p>These methods <em class=rfc2119>MUST</em> raise an
741  [[DOM XML Document Type Definition]] module >  <code>INVALID_CHARACTER_ERR</code> if <var>name</var> is <em>not</em> a legal
742  The [CODE(DOMi)@en[[[DocumentXDoctype]]]] Interface  <code>Name</code>
743    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
744  [2]  <a href="#ref-XML11">XML11</a>]</cite> according to the <abbr>XML</abbr>
745  @@ cast  version specified in the <code>xmlVersion</code> attribute of the
746    <a href="#Document"><code>Document</code></a> node.</p>
747  ** Constructors  
748    <div class="note memo">
749  [3] The  <p>Non$B!>(B<abbr>XML</abbr> case is intentionally left unspecified for now,
750  [DFN@en[[CODE(DOMm)@en[[[createDocumentTypeDefinition]]]] method]]  since <abbr>DOM</abbr> Level 3 Core specification
751  returns a [CODE(DOMi)@en[[[DocumentType]]]] node  <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>
752  or raises a [CODE(DOMi)@en[[[DOMException]]]].  does not define it for <a href="#Document"><code>Document</code></a>
753  It creates a [CODE(DOMi)@en[[[DocumentType]]]] node  methods.</p>
754  of the given name, belonging to the document.  
755    <p><var>name</var> does not have to be a namespace qualified name.</p>
756  [3] The  </div>
757  [DFN@en[[CODE(DOMm)@en[[[createElementTypeDefinition]]]] method]]  
758  returns an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node  </div>
 or raises a [CODE(DOMi)@en[[[DOMException]]]].  
 It creates an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node  
 of the given name, belonging to the document.  
   
 [4] The  
 [DFN@en[[CODE(DOMm)@en[[[createAttributeDefinition]]]] method]]  
 returns an [CODE(DOMi)@en[[[AttributeDefinition]]]] node  
 or raises a [CODE(DOMi)@en[[[DOMException]]]].  
 It creates an [CODE(DOMi)@en[[[AttributeDefinition]]]] node  
 of the given name, belonging to the document.  
   
 [10] The  
 [DFN@en[[CODE(DOMm)@en[[[createGeneralEntity]]]] method]]  
 returns an [CODE(DOMi)@en[[[Entity]]]] node  
 or raises a [CODE(DOMi)@en[[[DOMException]]]].  
 It creates an [CODE(DOMi)@en[[[Entity]]]] node,  
 which represents a general entity,  
 of the given name, belonging to the document.  
   
 [12] The  
 [DFN@en[[CODE(DOMm)@en[[[createNotation]]]] method]]  
 returns a [CODE(DOMi)@en[[[Notation]]]] node  
 or raises a [CODE(DOMi)@en[[[DOMException]]]].  
 It creates a [CODE(DOMi)@en[[[Notation]]]] node  
 of the given name, belonging to the document.  
   
 [5]  
 These method take a parameter [CODE(DOMp)@en[[[name]]]],  
 of type [CODE(DOMi)@en[[[DOMString]]]].  It is  
 the document type name, element type name,  
 or attribute name of the node to be created.  
   
 [6]  
 The [CODE(DOMm)@en[[[createDocumentTypeDefinition]]]]  
 method [['''MUST''']] create a [CODE(DOMi)@en[[[DocumentType]]]]  
 object with the following attribute values:  
 - [CODE(DOMa)@en[[[attributes]]]],  
 [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].  
 - [CODE(DOMa)@en[[[elementTypes]]]],  
 [CODE(DOMa)@en[[[generalEntities]]]],  
 [CODE(DOMa)@en[[[notations]]]]: Empty  
 [CODE(DOMi)@en[[[NamedNodeMap]]]]s.  
 - [CODE(DOMa)@en[[[childNodes]]]]: An empty  
 [CODE(DOMi)@en[[[NodeList]]]].  
 - [CODE(DOMa)@en[[[entities]]]]: The same  
 [CODE(DOMi)@en[[[NamedNodeMap]]]] as  
 [CODE(DOMa)@en[[[generalEntities]]]].  
 - [CODE(DOMa)@en[[[internalSubset]]]],  
 [CODE(DOMa)@en[[[publicId]]]], [CODE(DOMa)@en[[[systemId]]]]:  
 Empty strings.  
 - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:  
 [CODE(IDL)@en[[[false]]]].  
 - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].  
 - [CODE(DOMa)@en[[[ownerDocument]]]]: The  
 [CODE(DOMi)@en[[[Document]]]] node on which the method  
 is invoked.  
   
 In addition, it [['''MUST''']] be marked as containing  
 five general entity declarations for XML predefined  
 entities, i.e. [CODE(XML)@en[[[amp]]]], [CODE(XML)@en[[[lt]]]],  
 [CODE(XML)@en[[[gt]]]], [CODE(XML)@en[[[quot]]]], and  
 [CODE(XML)@en[[[apos]]]].  
   
 [8]  
 The [CODE(DOMm)@en[[[createElementTypeDefinition]]]]  
 method [['''MUST''']] create an  
 [CODE(DOMi)@en[[[ElementTypeDefinition]]]]  
 object with the following attribute values:  
 - [CODE(DOMa)@en[[[attributeDefinitions]]]]:  
 An empty [CODE(DOMi)@en[[[NamedNodeMap]]]].  
 - [CODE(DOMa)@en[[[attributes]]]],  
 [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].  
 - [CODE(DOMa)@en[[[childNodes]]]]: An empty  
 [CODE(DOMi)@en[[[NodeList]]]].  
 - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:  
 [CODE(IDL)@en[[[false]]]].  
 - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].  
 - [CODE(DOMa)@en[[[ownerDocument]]]]: The  
 [CODE(DOMi)@en[[[Document]]]] node on which the method  
 is invoked.  
 - [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]]:  
 [CODE(IDL)@en[[[null]]]].  
   
 @@ Ensure all attributes are defined  
   
 [9] The [CODE(DOMm)@en[[[createAttributeDefinition]]]]  
 method [['''MUST''']] create an  
 [CODE(DOMi)@en[[[AttributeDefinition]]]]  
 object with the following attribute values:  
 - [CODE(DOMa)@en[[[allowedTokens]]]]:  
 An empty [CODE(DOMi)@en[[[DOMStringList]]]].  
 - [CODE(DOMa)@en[[[attributes]]]],  
 [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].  
 - [CODE(DOMa)@en[[[childNodes]]]]: An empty  
 [CODE(DOMi)@en[[[NodeList]]]].  
 - [CODE(DOMa)@en[[[declaredType]]]]:  
 [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].  
 - [CODE(DOMa)@en[[[defaultType]]]]:  
 [CODE(DOMc)@en[[[UNKNOWN_DEFAULT]]]].  
 - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:  
 [CODE(IDL)@en[[[false]]]].  
 - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].  
 - [CODE(DOMa)@en[[[ownerDocument]]]]: The  
 [CODE(DOMi)@en[[[Document]]]] node on which the method  
 is invoked.  
 - [CODE(DOMa)@en[[[ownerElementTypeDefinition]]]]:  
 [CODE(IDL)@en[[[null]]]].  
   
 @@ Ensure all attributes are defined  
   
 @@ Should we keep these statements?:  
 However, if the <cfg::cfg|xml-id> configuration  
 parameter is set to <DOM::true> and the <P::name>  
 is <XA::xml:id>, then the [CODE(DOMa)@en[[[declaredType]]]]  
 attribute is set to  
 <C::AttributeDefinition.ID_ATTR>.  
 [CODE(DOMa)@en[[[defaultType]]]]?  
   
 [11] The [CODE(DOMm)@en[[[createGeneralEntity]]]]  
 method [['''MUST''']] create an [CODE(DOMi)@en[[[Entity]]]]  
 node with the following attribute values:  
 - [CODE(DOMa)@en[[[attributes]]]],  
 [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].  
 - [CODE(DOMa)@en[[[childNodes]]]]: An empty  
 [CODE(DOMi)@en[[[NodeList]]]].  
 - [CODE(DOMa)@en[[[manakaiDeclarationBaseURI]]]]:  
 No explicit value is set.  
 - [CODE(DOMa)@en[[[manakaiEntityBaseURI]]]]:  
 No explicit value is set.  
 - [CODE(DOMa)@en[[[manakaiEntityURI]]]]:  
 No explicit value is set.  
 - [CODE(DOMa)@en[[[manakaiHasReplacementTree]]]]:  
 [CODE(IDL)@en[[[false]]]].  
 - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:  
 [CODE(IDL)@en[[[false]]]].  
 - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].  
 - [CODE(DOMa)@en[[[notationName]]]]: [CODE(DOM)@en[[[null]]]].  
 - [CODE(DOMa)@en[[[ownerDocument]]]]: The  
 [CODE(DOMi)@en[[[Document]]]] node on which the method  
 is invoked.  
 - [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]]:  
 [CODE(IDL)@en[[[null]]]].  
 - [CODE(DOMa)@en[[[publicId]]]]: [CODE(DOM)@en[[[null]]]].  
 - [CODE(DOMa)@en[[[systemId]]]]: [CODE(DOM)@en[[[null]]]].  
   
 @@ Ensure all attributes are defined  
   
 @@ publicId and systemId should be empty string?  
   
 [13] The [CODE(DOMm)@en[[[createNotation]]]]  
 method [['''MUST''']] create a [CODE(DOMi)@en[[[Notation]]]]  
 node with the following attribute values:  
 - [CODE(DOMa)@en[[[attributes]]]],  
 [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].  
 - [CODE(DOMa)@en[[[childNodes]]]]: An empty  
 [CODE(DOMi)@en[[[NodeList]]]].  
 - [CODE(DOMa)@en[[[manakaiDeclarationBaseURI]]]]:  
 No explicit value is set.  
 - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:  
 [CODE(IDL)@en[[[false]]]].  
 - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].  
 - [CODE(DOMa)@en[[[ownerDocument]]]]: The  
 [CODE(DOMi)@en[[[Document]]]] node on which the method  
 is invoked.  
 - [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]]:  
 [CODE(IDL)@en[[[null]]]].  
 - [CODE(DOMa)@en[[[publicId]]]]: [CODE(DOM)@en[[[null]]]].  
 - [CODE(DOMa)@en[[[systemId]]]]: [CODE(DOM)@en[[[null]]]].  
   
 @@ Ensure all attributes are defined  
   
 [7]  
 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.  
759    
760  Otherwise, these method [['''MUST''']] return  
761  the newly created node.  <div class=section id=section-documenttype>
762  </pre>  <h3>Modifications to the <code id=DocumentType>DocumentType</code>
763    Interface</h3>
764    
765    <p>A <a href="#DocumentType"><code>DocumentType</code></a> interface
766    <em class=rfc2119>MAY</em> contain zero or more
767    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
768    nodes in the <code>NodeList</code> object contained in the
769    <code>childNodes</code> attribute of the
770    <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
771    
772    <p>If the <a href="#DocumentType"><code>DocumentType</code></a> node is created
773    during the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr>
774    document, the <code>NodeList</code> object in the <code>childNodes</code>
775    object <em class=rfc2119>MUST</em> contains the
776    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
777    nodes representing the processing instructions in the document type
778    definition of the document processed
779    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
780    <a href="#ref-XML11">XML11</a>]</cite> by the <abbr>XML</abbr> processor.  If
781    the <a href="#DocumentType"><code>DocumentType</code></a> node is marked as
782    <a href="#read-only">read$B!>(Bonly</a>, then all the child nodes
783    <em class=rfc2119>MUST</em> also be marked as
784    <a href="#read-only">read$B!>(Bonly</a>.</p>
785    
786    <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is created
787    from a
788    <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.doctype">document
789    type declaration information item</a>
790    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>,
791    the <code>NodeList</code> object in the <code>childNodes</code> attribute
792    of the node <em class=rfc2119>MUST</em> contain the
793    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes
794    created from any
795    <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.pi">processing
796    instruction information items</a> in the list in the [children] property of the
797    <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.doctype">document
798    type declaration item</a> in the same order.</p>
799    
800    <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is mapped to
801    a document type declaration information item, the list in the [children]
802    property <em class=rfc2119>MUST</em> contain the processng instruction
803    information items created from the
804    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes
805    in the <code>NodeList</code> object in the <code>childNodes</code> attribute
806    of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
807    
808    <p>The implementation of the
809    <a href="#DocumentType"><code>DocumentType</code></a> interface
810    <em class=rfc2119>MUST</em> be modified as the following
811    <a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p>
812    <pre class=idl><code>// Modifications to the DocumentType interface
813      attribute DOMString <a href="#publicId">publicId</a>;
814      attribute DOMString <a href="#systemId">systemId</a>;
815    
816      attribute DOMString <a href="#internalSubset">internalSubset</a>;
817    </code></pre>
818    
819    <p>The <code id=publicId>publicId</code> attribute and the
820    <code id=systemId>systemId</code> attribute of
821    <a href="#DocumentType"><code>DocumentType</code></a>,
822    <a href="#Entity"><code>Entity</code></a>, and
823    <a href="#Notation"><code>Notation</code></a> interfaces are no longer
824    read$B!>(Bonly.</p>
825    
826    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
827    <code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is
828    <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it <em class=rfc2119>MUST</em>
829    set the specified value as the value associated to the attribute.  No
830    normalization, relative reference resolution, or lexical validation is
831    performed. <span class=ed>@@ If the new value is <code>null</code>, should an e
832    mpty string be set?</span></p>
833    
834    <div class="note memo">
835    <p>Setting an invalid identifier might make the node unserializable.
836    Setting a public identifier while leaveing system identifier unspecified
837    would also make the <a href="#DocumentType"><code>DocumentType</code></a>
838    or <a href="#Entity"><code>Entity</code></a> node unserializable.</p>
839    </div>
840    
841    <div class=ed>
842    <p>ISSUE: In HTML5, Firefox 1.5, and Opera 9, not specifying public or system identifier results in empty strings.</p>
843    </div>
844    
845    <p>The <code id=internalSubset>internalSubset</code> attribute of the
846    <a href="#DocumentType"><code>DocumentType</code></a> interface is no longer
847    read$B!>(Bonly.</p>
848    
849    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
850    <code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is
851    <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it <em class=rfc2119>MUST</em>
852    set the specified value as the value associated to the attribute.  No
853    normalization, or lexical validation is performed.  <span class=ed>@@ If the
854    new value is <code>null</code>, should an empty string be set?</span></p>
855    
856  </div>  </div>
857    
858  <div class=section id=section-documenttypedefinition>  <div class=section id=section-documenttypedefinition>
859  <h2>The <code>DocumentTypeDefinition</code> Interface</h2>  <h3>The <code>DocumentTypeDefinition</code> Interface</h3>
860    
861  <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {  <p>The <a href="#DocumentType"><code>DocumentType</code></a> nodes
862      <em class=rfc2119>MUST</em> also implement the
863  }</code></pre>  <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
864    interface.</p>
865    
866  <pre class=ed>  <p>An instance of the
867  [1] In an implementation that supports the  <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
868  [CODE(URI)@en[[[http://suika.fam.cx/www/2006/feature/XDoctype]]]]  interface <em class=rfc2119>MUST</em> be able to be obtained by using
869  feature, a [CODE(DOMi)@en[[[DocumentType]]]] node  binding$B!>(Bspecific casting methods on an instance of the
870  must implement the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]  <a href="#DocumentType"><code>DocumentType</code></a> interface (if such
871  interface.  See [[DOM XML Document Type Definition]>>3] for  casting methods are available) or by using the method <code>getFeature</code>
872  details.  with parameter values
873    <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
874    and <a href="#feature-XDoctype-3.0"><code>3.0</code></a> respectively (if the
875  ** Children  <a href="#DocumentType"><code>DocumentType</code></a> node supports the
876    feature <code>Core</code> version <code>3.0</code>
877  [2] The [DFN@en[[CODE(DOMa)@en[[[elementTypes]]]] attribute]]  <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p>
878  of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface  
879  is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that  <div class="note memo">
880  contains all element types belongs to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]  <p>This interface is a separated interface from the
881  node.  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].  <a href="#DocumentType"><code>DocumentType</code></a>, not a set of extensions
882  The attribute is read-only.  to the <a href="#DocumentType"><code>DocumentType</code></a>,
883    for the historical reason.</p>
 What are contained in this collection depends on how  
 the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node was created.  If the  
 node was created as the result of parsing of an XML document,  
 it [['''MUST''']]  contain all element types whose element type and / or  
 attribute definition list declaration are encountered by and provided for the DOM  
 implementation from the XML processor.  Note that the XML processor might not  
 provide a part of or entire such information depending on the configuration.  
 If more than one declarations for an element type or an attribute is available  
 at the time of the definition node construction, then declarations other than  
 the first ones [['''MUST''']] be discarded.  
884    
885  The attribute [['''MUST''']] return the [CODE(DOMi)@en[[[NamedNodeMap]]]]  <p class=ed>Should the interface be merged with
886  object that contains all the [CODE(DOMi)@en[[[ElementTypeDefinition]]]] nodes  <a href="#DocumentType"><code>DocumentType</code></a>?</p>
887  belong to the node.  The returned [CODE(DOMi)@en[[[NamedNodeMap]]]] object  </div>
 [['''MUST''']] be read-only if and only if the node is read-only.  
 Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live  
 and therefore any change of read-only flag on the node is immediately  
 reflected by that of the object.  
888    
889  [3] The [DFN@en[[CODE(DOMa)@en[[[generalEntities]]]] attribute]]  <p>The
890  of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface  <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
891  is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that contains all the  interface <em class=rfc2119>MUST</em> be implemented as the following
892  general entities belong to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node.  <a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p>
893  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].  <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {
894  The attribute is read-only.    readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>;
895      readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>;
896      readonly attribute NamedNodeMap <a href="#notations">notations</a>;
897    
898      <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#getElementTypeDefinitionNode">getElementTypeDefinitionNode</a>
899        (in DOMString <a href="#getElementTypeDefinitionNode-name"><var>name</var></a>);
900      <a href="#Entity">Entity</a> <a href="#getGeneralEntityNode">getGeneralEntityNode</a>
901        (in DOMString <a href="#getGeneralEntityNode-name"><var>name</var></a>);
902      <a href="#Notation">Notation</a> <a href="#getNotationNode">getNotationNode</a>
903        (in DOMString <a href="#getNotationNode-name"><var>name</var></a>);
904    
905      void <a href="#setElementTypeDefinitionNode">setElementTypeDefinitionNode</a>
906        (in DOMString <a href="#setElementTypeDefinitionNode-node"><var>node</var></a>)
907        raises (DOMException);
908      void <a href="#setGeneralEntityNode">setGeneralEntityNode</a>
909        (in DOMString <a href="#setGeneralEntityNode-node"><var>node</var></a>)
910        raises (DOMException);
911      void <a href="#setNotationNode">setNotationNode</a>
912        (in DOMString <a href="#setNotationNode-node"><var>node</var></a>)
913        raises (DOMException);
914    }</code></pre>
915    
916    <dl>
917    <dt><dfn id=elementTypes class=dom-attr><code>elementTypes</code></dfn> of
918    type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
919      <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that
920      contains all the element type definitions belonging to the
921      <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
922    
923      <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
924      <code>NamedNodeMap</code> object that contains all the
925      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
926      nodes belonging to the <code>DocumentType</code> node.  The
927      <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be read$B!>(Bonly
928      if and only if the node is <a href="#read-only">read$B!>(Bonly</a>.  The
929      <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be
930      <a href="#live">live</a>.</p>
931    
932      <p>If the <code>DocumentType</code> node is created during the process
933      to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, the following
934      requirements are applied:  The <code>NamedNodeMap</code> object in the
935      <a href="#elementTypes"><code>elementType</code></a> attribute
936      <em class=rfc2119>MUST</em> be so transformed that the object contains
937      the <code>ElementTypeDefinition</code> nodes for the element types
938      whose name is presented as the <code>Name</code> of the element type or
939      attribute definition list declarations processed
940      <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
941      <a href="#ref-XML11">XML11</a>]</cite> by the <abbr>XML</abbr>
942      processor.  If there are more than one element type declarations for an
943      element type, then the declarations other than the first one
944      <em class=rfc2119>MUST</em> be ignored for the purpose of constructing the
945      <code>NamedNodeMap</code> object.</p></dd>
946    <dt><dfn id=generalEntities class=dom-attr><code>generalEntities</code></dfn>
947    of type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
948      <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that
949      contains all the general entities belonging to the
950      <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
951      
952      <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
953      same value as the <code id=entities>entities</code> attribute (defined in the
954      <a href="#DocumentType"><code>DocumentType</code></a> interface) of the same
955      node.</p>
956    
957      <div class="note memo">
958        <p>This attribute is part of the interface for historical reason.</p>
959      </div></dd>
960    <!--
961  All entities declared in the document type definition  All entities declared in the document type definition
962  contained in or referenced from the document entity  contained in or referenced from the document entity
963  might not be exposed through this collection, depending  might not be exposed through this collection, depending
# Line 472  representing general entities belong to Line 977  representing general entities belong to
977  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
978  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
979  reflected by that of the object.  reflected by that of the object.
980    -->
981  The attribute [['''MUST''']] return the same value as the  <dt><dfn id=notations class=dom-attr><code>notations</code></dfn> of type
982  [CODE(DOMa)@en[[[entites]]]] attribute of the  <code>notations</code>, read$B!>(Bonly</code>
983  [CODE(DOMi)@en[[[DocumentType]]]] interface on the same node.    <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that
984      contains all the notations belonging to the
985  [4] The [DFN@en[[CODE(DOMa)@en[[[notations]]]] attribute]]    <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
986  of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface    
987  is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that contains    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
988  all the notations belong to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]    same value as the <code>notations</code> attribute (defined in the
989  node.  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].    <a href="#DocumentType"><code>DocumentType</code></a> interface) of the same
990  The attribute is read-only.    node.</p>
991    
992      <div class="note memo">
993        <p>This attribute is part of the interface for historical reason.</p>
994        <p>Implementations are not required to implement the
995        <code>notations</code> attribute twice (for
996        <a href="#DocumentType"><code>DocumentType</code></a> and
997        <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
998        interfaces); they share exactly same definition.</p>
999      </div></dd>
1000    <!--
1001  If the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node is  If the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node is
1002  created from an XML document, duplicate notation declarations, if any, in DTD  created from an XML document, duplicate notation declarations, if any, in DTD
1003  [['''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 1021  representing notations belong to the nod
1021  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
1022  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
1023  reflected by that of the object.  reflected by that of the object.
1024    -->
1025    <dt><dfn id=getElementTypeDefinitionNode class=dom-method><code>getElementTypeDefinitionNode</code></dfn>,
1026    method</dt>
1027      <dd><p>Returns the
1028      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
1029      with the specified name.</p>
1030    
1031      <p>The
1032      <dfn id=getElementTypeDefinitionNode-name class=dom-param><var>name</var></dfn>
1033      parameter is the name of the element type.</p>
1034    
1035      <p>When invoked, the method <em class=rfc2119>MUST</em> return the
1036      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node,
1037      whose <a href="#nodeName"><code>nodeName</code></a> is equal to
1038      <a href="#getElementTypeDefinitionNode-name"><var>name</var></a>, in the
1039      <code>NamedNodeMap</code> object in the
1040      <a href="#elementTypes"><code>elementTypes</code></a> attribute of the
1041      node.  If there is no such node, it <em class=rfc2119>MUST</em> return
1042      <code>null</code>.</p></dd>
1043    <dt><dfn id=getElementTypeDefinitionNode class=dom-method><code>getElementTypeDefinitionNode</code></dfn>,
1044    method</dt>
1045      <dd><p>Returns the
1046      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
1047      with the specified name.</p>
1048    
1049      <p>The
1050      <dfn id=getElementTypeDefinitionNode-name class=dom-param><var>name</var></dfn>
1051      parameter is the name of the element type.</p>
1052    
1053      <p>When invoked, the method <em class=rfc2119>MUST</em> return the
1054      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node,
1055      whose <a href="#nodeName"><code>nodeName</code></a> is equal to
1056      <a href="#getElementTypeDefinitionNode-name"><var>name</var></a>, in the
1057      <code>NamedNodeMap</code> object in the
1058      <a href="#elementTypes"><code>elementTypes</code></a> attribute of the
1059      node.  If there is no such node, it <em class=rfc2119>MUST</em> return
1060      <code>null</code>.</p></dd>
1061    <dt><dfn id=getGeneralEntityNode class=dom-method><code>getGeneralEntityNode</code></dfn>,
1062    method</dt>
1063      <dd><p>Returns the <a href="#Entity"><code>Entity</code></a> node
1064      with the specified name.</p>
1065    
1066      <p>The <dfn id=getEntityNode-name class=dom-param><var>name</var></dfn>
1067      parameter is the name of the general entity.</p>
1068    
1069      <p>When invoked, the method <em class=rfc2119>MUST</em> return the
1070      <a href="#Entity"><code>Entity</code></a> node,
1071      whose <a href="#nodeName"><code>nodeName</code></a> is equal to
1072      <a href="#getEntityNode-name"><var>name</var></a>, in the
1073      <code>NamedNodeMap</code> object in the
1074      <a href="#entities"><code>entities</code></a> attribute of the
1075      node.  If there is no such node, it <em class=rfc2119>MUST</em> return
1076      <code>null</code>.</p></dd>
1077    <dt><dfn id=getNotationNode class=dom-method><code>getNotationNode</code></dfn>,
1078    method</dt>
1079      <dd><p>Returns the <a href="#Notation"><code>Notation</code></a> node
1080      with the specified name.</p>
1081    
1082      <p>The
1083      <dfn id=getNotationNode-name class=dom-param><var>name</var></dfn>
1084      parameter is the name of the notation.</p>
1085    
1086      <p>When invoked, the method <em class=rfc2119>MUST</em> return the
1087      <a href="#Notation"><code>Notation</code></a> node,
1088      whose <a href="#nodeName"><code>nodeName</code></a> is equal to
1089      <a href="#getNotationNode-name"><var>name</var></a>, in the
1090      <code>NamedNodeMap</code> object in the
1091      <a href="#notations"><code>notations</code></a> attribute of the
1092      node.  If there is no such node, it <em class=rfc2119>MUST</em> return
1093      <code>null</code>.</p></dd>
1094    <dt><dfn id=setElementTypeDefinitionNode class=dom-method><code>setElementTypeDefinitionNode</code></dfn>,
1095    method</dt>
1096      <dd class=ed>@@</dd>
1097    <dt><dfn id=setGeneralEntityNode class=dom-method><code>setGeneralEntityNode</code></dfn>,
1098    method</dt>
1099      <dd class=ed>@@</dd>
1100    <dt><dfn id=setNotationNode class=dom-method><code>setNotationNode</code></dfn>,
1101    method</dt>
1102      <dd class=ed>@@</dd>
1103    </dl>
1104    
1105  A DOM implementation is not required to implement the  <div class=ed>
1106  [CODE(DOMa)@en[[[notations]]]] attribute twice  <p>A future version of this interface might define the
1107  for the [CODE(DOMi)@en[[[DocumentType]]]] and  <code>parameterEntities</code> and getter/setter for parameter entities.
1108  the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interfaces;  </div>
 the latter is defined to contain the same value as the former.  
   
1109    
 ** 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>  
1110  </div>  </div>
1111    
1112  <div class=section id=section-elementtypedefinition>  <div class=section id=section-elementtypedefinition>
1113  <h2>The <code>ElementTypeDefinition</code> Interface</h2>  <h3>The <code>ElementTypeDefinition</code> Interface</h3>
1114    
1115  <pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> {  <p>The nodes of type
1116      <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>
1117    represents an element type definition.  Such a node
1118    <em class=rfc2119>MUST</em> implement the
1119    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1120    interface, which extends the <a href="#Node"><code>Node</code></a>
1121    interface.</p>
1122    
1123    <p>An element type definition represents a definition of the element type.
1124    It is corresponding to the element type declaration in <abbr>DTD</abbr>.
1125    However, an
1126    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
1127    does not represent the element type definition in <abbr>DTD</abbr> itself.  
1128    Even if there are more than one element type declarations for an element type
1129    in <abbr>DTD</abbr>, the result <abbr>DOM</abbr> will contain only an
1130    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1131    node for that element type.  In addition, if there are attribute definition
1132    declarations for an element type, even when there is no element type
1133    declaration for that element type, the <abbr>DOM</abbr> will contain an
1134    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1135    node for that element type.</p>
1136    
1137    <p>An <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1138    node cannot be a child of any node.  An
1139    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
1140    cannot have any child node.</p>
1141    
1142    <p>The <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1143    interface <em class=rfc2119>MUST</em> be implemented as the following
1144    <a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p>
1145    <pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> : <a href="#Node">Node</a> {
1146      readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
1147    
1148      readonly attribute NamedNodeMap <a href="#attributeDefinitions">attributeDefinitions</a>;
1149      <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#getAttributeDefinitionNode">getAttributeDefinitionNode</a>
1150        (in DOMString <a href="#getAttributeDefinitionNode-name"><var>name</var></a>);
1151      void <a href="#setAttributeDefinitionNode">setAttributeDefinitionNode</a>
1152        (in <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#setAttributeDefinitionNode-name"><var>node</var></a>)
1153        raises (DOMException);
1154  }</code></pre>  }</code></pre>
1155    
1156  <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members  <dl>
1157    <dt><dfn id=ownerDocumentTypeDefinition class=dom-attr><code>ownerDocumentTypeDefinition</code></dfn>
1158    of type <a href="#DocumentType"><code>DocumentType</code></a>, read$B!>(Bonly</dt>
1159      <dd><p>The
1160      <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
1161      attribute of
1162      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
1163      <a href="#Entity"><code>Entity</code></a>, and
1164      <a href="#Notation"><code>Notation</code></a> interfaces contain the
1165      <a href="#DocumentType"><code>DocumentType</code></a> node to which the node
1166      is attached.</p>
1167    
1168      <p>On getting, the attribute <em class=rfc2119>MUST</em> return a
1169      <a href="#DocumentType"><code>DocumentType</code></a> node.  It
1170      <em class=rfc2119>MUST</em> be such a node that whose
1171      <a href="#elementTypes"><code>elementTypes</code></a> (for an
1172      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1173      node), <a href="#entities"><code>entities</code></a> (for an
1174      <a href="#Entity"><code>Entity</code></a> node), or
1175      <a href="#notations"><code>notations</code></a> (for a
1176      <a href="#Notation"><code>Notation</code></a> node) attribute contains the
1177      <code>NamedNodeMap</code> object that contains the node.  If there is no such
1178      a <a href="#DocumentType"><code>DocumentType</code></a> node,
1179      then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p></dd>
1180    <dt><dfn id=attributeDefinitions class=dom-attr><code>attributeDefinitions</code></dfn>
1181    of type NamedNodeMap, read$B!>(Bonly</dt>
1182      <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that
1183      contains all the attribute definitions belonging to the
1184      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1185      node.</p>
1186    
1187      <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
1188      <code>NamedNodeMap</code> object that contains all the
1189      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1190      belonging to the
1191      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.
1192      The <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be
1193      read$B!>(Bonly if and only if the node is <a href="#read-only">read$B!>(Bonly</a>.  
1194      The <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be
1195      <a href="#live">live</a>.</p>
1196      
1197      <p>If the
1198      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
1199      is created during the process to create a <abbr>DOM</abbr> from an
1200      <abbr>XML</abbr> document, the following requirements are applied:  The
1201      <code>NamedNodeMap</code> object in the
1202      <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
1203      attribute <em class=rfc2119>MUST</em> be so transformed that the object
1204      contains the
1205      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1206      corresponding to the attribute definitions in the attribute definition
1207      list declarations processed
1208      <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1209      <a href="#ref-XML11">XML11</a>]</cite> by the <abbr>XML</abbr> processor and
1210      associated to the element type represented by the node.  If there are more
1211      than one attribute definitions for an attribute, then the definitions other
1212      than the first one <em class=rfc2119>MUST</em> be ignored for the purpose
1213      of constructing the <code>NamedNodeMap</code> object.</p></dd>
1214    <dt><dfn id=getAttributeDefinitionNode class=dom-method><code>getAttributeDefinitionNode</code></dfn>,
1215    method</dt>
1216      <dd><p>Return the
1217      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1218      with the specified name.</p>
1219    
1220      <p>The
1221      <dfn id=getAttributeDefinitionNode-name class=dom-param><var>name</var></dfn>
1222      parameter is the name of the attribute.</p>
1223    
1224      <p>When invoked, the method <em class=rfc2119>MUST</em> return the
1225      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node,
1226      whose <a href="#nodeName"><code>nodeName</code></a> attribute value is
1227      equal to <a href="#getAttributeDefinitionNode-name"><var>name</var></a>,
1228      in the <code>NamedNodeMap</code> in the
1229      <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
1230      attribute of the node.  If there is no such node, it
1231      <em class=rfc2119>MUST</em> return <code>null</code>.</p></dd>
1232    <dt><dfn id=setAttributeDefinitionNode class=dom-method><code>setAttributeDefinitionNode</code></dfn>,
1233    method</dt>
1234      <dd class=ed>@@</dd>
1235    </dl>
1236    
1237  [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute  <div class=ed>
1238  of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object  <p>A future version of the specification might define a set of attributes
1239  [['''MUST''']] return [CODE(IDL)@en[[[null]]]].  and methods for representing and accessing to the content model of the
1240    element type.</p>
1241  [4] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute  </div>
 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  
   
 [5] The  
 [DFN@en[[CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute]]  
 of the [CODE(DOMi)@en[[[ElementTypeDefinition]]]]  
 interface is defined in [[manakai//DOM Extensions]>>50].</pre>  
1242  </div>  </div>
1243    
1244  <div class=section id=section-attributedefinition>  <div class=section id=section-attributedefinition>
1245  <h2>The <code>AttributeDefinition</code> Interface</h2>  <h3>The <code>AttributeDefinition</code> Interface</h3>
1246    
1247  <pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> {  <p>The nodes of type
1248    <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>
1249    represents an attribute definition.  Such a node
1250    <em class=rfc2119>MUST</em> implement the
1251    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> interface,
1252    which extends the <a href="#Node"><code>Node</code></a> interface.</p>
1253    
1254    <p>An attribute definition represents a definition of the attribute
1255    associated to an element type.  It is corresponding to the attribute definition
1256    in the attribute list declaration in <abbr>DTD</abbr>.  However, an
1257    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node does
1258    not represent the attribute definition in <abbr>DTD</abbr> itself.  Even if
1259    there are more than one attribute definitions for an attribute of an element
1260    type in <abbr>DTD</abbr>, the result <abbr>DOM</abbr> will contain only an
1261    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node for
1262    that attribute.</p>
1263    
1264    <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1265    node cannot be a child of any node.  An
1266    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1267    can have zero or more child nodes of same kinds as those allowed for
1268    <code>Attr</code> nodes
1269    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p>
1270    
1271    <p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1272    interface <em class=rfc2119>MUST</em> be implemented as the following
1273    <a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p>
1274    <pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> : <a href="#Node">Node</a> {
1275      <span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span>
1276      const unsigned short <a href="#NO_TYPE_ATTR">NO_TYPE_ATTR</a> = 0;
1277      const unsigned short <a href="#CDATA_ATTR">CDATA_ATTR</a> = 1;
1278      const unsigned short <a href="#ID_ATTR">ID_ATTR</a> = 2;
1279      const unsigned short <a href="#IDREF_ATTR">IDREF_ATTR</a> = 3;
1280      const unsigned short <a href="#IDREFS_ATTR">IDREFS_ATTR</a> = 4;
1281      const unsigned short <a href="#ENTITY_ATTR">ENTITY_ATTR</a> = 5;
1282      const unsigned short <a href="#ENTITIES_ATTR">ENTITIES_ATTR</a> = 6;
1283      const unsigned short <a href="#NMTOKEN_ATTR">NMTOKEN_ATTR</a> = 7;
1284      const unsigned short <a href="#NMTOKENS_ATTR">NMTOKENS_ATTR</a> = 8;
1285      const unsigned short <a href="#NOTATION_ATTR">NOTATION_ATTR</a> = 9;
1286      const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10;
1287      const unsigned short <a href="#UNKNOWN_ATTR">UNKNOWN_ATTR</a> = 11;
1288    
1289      <span class=comment>// <a href="#DefaultValueType">DefaultValueType</a></span>
1290      const unsigned short <a href="#UNKNOWN_DEFAULT">UNKNOWN_DEFAULT</a> = 0;
1291      const unsigned short <a href="#FIXED_DEFAULT">FIXED_DEFAULT</a> = 1;
1292      const unsigned short <a href="#REQUIRED_DEFAULT">REQUIRED_DEFAULT</a> = 2;
1293      const unsigned short <a href="#IMPLIED_DEFAULT">IMPLIED_DEFAULT</a> = 3;
1294      const unsigned short <a href="#EXPLICIT_DEFAULT">EXPLICIT_DEFAULT</a> = 4;
1295        
1296  }</code></pre>    readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;
1297    
1298  <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members    readonly attribute unsigned short <a href="#declaredType">declaredType</a>;
1299      readonly attribute DOMStringList <a href="#allowedTokens">allowedTokens</a>;
1300      readonly attribute unsigned short <a href="#defaultType">defaultType</a>;
1301    }</code></pre>
1302    
1303  [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute  <dl>
1304  of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  <dt><dfn id=ownerElementTypeDefinition class=dom-attr><code>ownerElementTypeDefinition</code></dfn>
1305  [['''MUST''']] return [CODE(IDL)@en[[[null]]]].  of type
1306    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
1307  [9] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute  read$B!>(Bonly</dt>
1308  of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object    <dd><p>The
1309  [['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> to
1310  of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the    which the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1311  [CODE(DOMi)@en[[[AttributeDefinition]]]] object.    node belongs.</p>
1312  Note that it might be [CODE(IDL)@en[[[null]]]].  
1313      <p>On getting, the attribute <em class=rfc2119>MUST</em> return an
1314  [1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.
1315  of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object    It <em class=rfc2119>MUST</em> be such a node that whose
1316  [['''MUST''']] return the name of the attribute.    <a href="#attributeDefinitons"><code>attributeDefinitions</code></a>
1317      attribute contains the <code>NamedNodeMap</code> object that contains
1318  [2] The getter of the [CODE(DOMa)@en[[[nodeValue]]]] attribute    the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1319  of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object    node.  If there is no such an
1320  [['''MUST''']] return the normalized default value    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node,
1321  of the attribute.    then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p>
1322    <dt><dfn id=declaredType class=dom-attr><code>declaredType</code></dfn> of type
1323  @@  <code>unsigned short</code></dt>
1324      <dd><p>The declared type
1325  [4] The getter of the [CODE(DOMa)@en[[[textContent]]]]    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1326  attribute of an [CODE(DOMi)@en[[[AttributeDefinition]]]]    <a href="#ref-XML11">XML11</a>]</cite> of the attribute.  It is expected that
1327  object [['''MUST''']] behave as if it were an    this attribute contains a value from the definition group
1328  [CODE(DOMi)@en[[[Attr]]]] object.    <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>.</p>
1329    
1330  The setter of the [CODE(DOMa)@en[[[textContent]]]] attribute    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
1331  of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object    value associated to this attribute.</p>
1332  [['''MUST''']] behave as if the following algorithm  
1333  is performed:    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1334  = If the [CODE(DOMi)@en[[[AttributeDefinition]]]]    <code>NO_MODIFICATION_ALLOWED_ERR</code> if the
1335  object is read-only, then throw an    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1336  [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].    is <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it
1337  = Remove any child node the node has.    <em class=rfc2119>MUST</em> set the specified value as the value
1338  = If the new value is not empty and not [CODE(IDL)@en[[[null]]]],    associated to this attribute.</p>
1339  then create a [CODE(DOMi)@en[[[Text]]]] node  
1340  whose [CODE(DOMa)@en[[[data]]]] is the new value    <p>If the <code>AttributeDefinition</code> node is created during the process
1341  and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].    to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, an
1342      appropriate value from the
1343  ** Definition groups    <a href="#DeclaredValueType"><code>DeclaredValueType</code></a> constant
1344      group <em class=rfc2119>MUST</em> be set to the attribute.</p>
1345  [6] The  
1346  [DFN@en[definition group [CODE(DOM)@en[[[DeclaredValueType]]]]]]    <!-- DeclaredValueType -->
1347  contains integers indicating the type of  <p>The definition group
1348  attribute value:  <dfn id=DeclaredValueType><code>DeclaredValueType</code></dfn> contains
1349  ,[CODE(DOMc)@en[[[NO_TYPE_ATTR]]]],[CODE(IDL)[[[0]]]],The attribute value type corresponding to [[no value]] in XML Information Set.  integers indicating the declared type of attributes.  The definition
1350  ,[CODE(DOMc)@en[[[CDATA_ATTR]]]],[CODE(IDL)[[[1]]]],The attribute value type is [CODE(XML)@en[[[CDATA]]]].  group contains the following constants:</p>
1351  ,[CODE(DOMc)@en[[[ID_ATTR]]]],[CODE(IDL)[[[2]]]],The attribute value type is [CODE(XML)@en[[[ID]]]].  
1352  ,[CODE(DOMc)@en[[[IDREF_ATTR]]]],[CODE(IDL)[[[3]]]],The attribute value type is [CODE(XML)@en[[[IDREF]]]].  <table>
1353  ,[CODE(DOMc)@en[[[IDREFS_ATTR]]]],[CODE(IDL)[[[4]]]],The attribute value type is [CODE(XML)@en[[[IDREFS]]]].  <thead>
1354  ,[CODE(DOMc)@en[[[ENTITY_ATTR]]]],[CODE(IDL)[[[5]]]],The attribute value type is [CODE(XML)@en[[[ENTITY]]]].  <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
1355  ,[CODE(DOMc)@en[[[ENTITIES_ATTR]]]],[CODE(IDL)[[[6]]]],The attribute value type is [CODE(XML)@en[[[ENTITIES]]]].  </thead>
1356  ,[CODE(DOMc)@en[[[NMTOKEN_ATTR]]]],[CODE(IDL)[[[7]]]],The attribute value type is [CODE(XML)@en[[[NMTOKEN]]]].  <tbody>
1357  ,[CODE(DOMc)@en[[[NMTOKENS_ATTR]]]],[CODE(IDL)[[[8]]]],The attribute value type is [CODE(XML)@en[[[NMTOKENS]]]].  <tr>
1358  ,[CODE(DOMc)@en[[[NOTATION_ATTR]]]],[CODE(IDL)[[[9]]]],The attribute value type is [CODE(XML)@en[[[NOTATION]]]].  <th scope=row><dfn id=NO_TYPE_ATTR class=dom-const><code>NO_TYPE_ATTR</code>
1359  ,[CODE(DOMc)@en[[[ENUMERATION_ATTR]]]],[CODE(IDL)[[[10]]]],The attribute value is enumeration type.  <td><code>0</code><td><a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">No
1360  ,[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."  value</a>
1361    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>.</tr>
1362  The type of these constants are  <tr>
1363  [CODE(IDL)@en[[[unsigned]] [[short]]]].  <th scope=row><dfn id=CDATA_ATTR class=dom-const><code>CDATA_ATTR</code>
1364    <td><code>1</code><td><code>CDATA</code>
1365  If no attribute type information is provided,  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1366  or if the source of that information does not  <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1367  distinguish [[no value]] and [[unknown]] as in  <tr>
1368  XML Information Set, then the  <th scope=row><dfn id=ID_ATTR class=dom-const><code>ID_ATTR</code>
1369  [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]] value  <td><code>2</code><td><code>ID</code>
1370  [['''MUST''']] be used.  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1371    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1372  ;; A newly created [CODE(DOMi)@en[[[AttributeDefinition]]]]  <tr>
1373  object by [CODE(DOMm)@en[[[createAttributeDefinition]]]]  <th scope=row><dfn id=IDREF_ATTR class=dom-const><code>IDREF_ATTR</code>
1374  method has [CODE(DOMa)@en[[[declaredType]]]] attribute  <td><code>3</code><td><code>IDREF</code>
1375  set to [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1376    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1377  If the source of the attribute type information  <tr>
1378  does not distinguish [[no value]] and / or [[unknown]]  <th scope=row><dfn id=IDREFS_ATTR class=dom-const><code>IDREFS_ATTR</code>
1379  and [CODE(XML)@en[[[CDATA]]]], then the  <td><code>4</code><td><code>IDREFS</code>
1380  [CODE(DOMc)@en[[[CDATA_ATTR]]]] value [['''MUST''']]  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1381  be used.  <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1382    <tr>
1383  [11]  <th scope=row><dfn id=ENTITY_ATTR class=dom-const><code>ENTITY_ATTR</code>
1384  In Perl binding, the objects implementing the  <td><code>5</code><td><code>ENTITY</code>
1385  [CODE(DOMi)@en[[[Attr]]]] interface [['''MUST''']]  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1386  also implement the [CODE(DOM)@en[[[DeclaredValueType]]]]  <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1387  constant group.  <tr>
1388    <th scope=row><dfn id=ENTITIES_ATTR class=dom-const><code>ENTITIES_ATTR</code>
1389  [7] The  <td><code>6</code><td><code>ENTITIES</code>
1390  [DFN@en[definition group [CODE(DOM)@en[[[DefaultValueType]]]]]]  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1391  contains integers indicating the type of  <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1392  default attribute value:  <tr>
1393  ,[CODE(DOMc)@en[[[UNKNOWN_DEFAULT]]]],[CODE(IDL)[[[0]]]],The default value is unknown.  <th scope=row><dfn id=NMTOKEN_ATTR class=dom-const><code>NMTOKEN_ATTR</code>
1394  ,[CODE(DOMc)@en[[[FIXED_DEFAULT]]]],[CODE(IDL)[[[1]]]],The default value is provided and the attribute is [CODE(XML)@en[#[[FIXED]]]] to that value.  <td><code>7</code><td><code>NMTOKEN</code>
1395  ,[CODE(DOMc)@en[[[REQUIRED_DEFAULT]]]],[CODE(IDL)[[[2]]]],An attribute specification is [CODE(XML)@en[#[[REQUIRED]]]] for the attribute.  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1396  ,[CODE(DOMc)@en[[[IMPLIED_DEFAULT]]]],[CODE(IDL)[[[3]]]],The default value is [CODE(XML)@en[#[[IMPLIED]]]].  <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1397  ,[CODE(DOMc)@en[[[EXPLICIT_DEFAULT]]]],[CODE(IDL)[[[4]]]],The default value is provided but the attribute is not fixed to it.  <tr>
1398    <th scope=row><dfn id=NMTOKENS_ATTR class=dom-const><code>NMTOKENS_ATTR</code>
1399  The type of these constants are  <td><code>8</code><td><code>NMTOKENS</code>
1400  [CODE(IDL)@en[[[unsigned]] [[short]]]].  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1401    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1402  If the source of the attribute default value type  <tr>
1403  does not distinguish the [CODE(XML)@en[#[[IMPLIED]]]]  <th scope=row><dfn id=NOTATION_ATTR class=dom-const><code>NOTATION_ATTR</code>
1404  default and unknown default, then the  <td><code>9</code><td><code>NOTATION</code>
1405  [CODE(DOMc)@en[[[IMPLIED_DEFAULT]]]] value  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1406  [['''MUST''']] be used.  <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1407    <tr>
1408  ;; A newly created [CODE(DOMi)@en[[[AttributeDefinition]]]]  <th scope=row><dfn id=ENUMERATION_ATTR class=dom-const><code>ENUMERATION_ATTR</code>
1409  object by [CODE(DOMm)@en[[[createAttributeDefinition]]]]  <td><code>10</code><td>Enumeration
1410  method has [CODE(DOMa)@en[[[declaredType]]]] attribute  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1411  set to [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].  <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1412    <tr>
1413  ** Tree-relationship Attributes  <th scope=row><dfn id=UNKNOWN_ATTR class=dom-const><code>UNKNOWN_ATTR</code>
1414    <td><code>11</code><td><a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">Unknown</a>,
1415  [10]  because no declaration for the attribute has been read but the
1416  The  <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.document">[all declaration processed]</a>
1417  [DFN@en[[CODE(DOMa)@en[[[ownerElementTypeDefinition]]]] attribute]]  property
1418  of the [CODE(DOMi)@en[[[AttributeDefinition]]]] interface  <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>
1419  is read-only and of type  would be false.</tr>
1420  [CODE(DOMi)@en[[[ElementTypeDefinition]]]].  </tbody>
1421  It is the [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node  </table>
1422  which the [CODE(DOMi)@en[[[AttributeDefinition]]]] node  
1423  belong to.  <p>If no attribute type information is available, or if the source
1424    of the information does not distinguish
1425  If the [CODE(DOMi)@en[[[AttributeDefinition]]]] node  <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">no
1426  is included in the [CODE(DOMa)@en[[[attributeDefinitions]]]]  value</a> and
1427  list of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node,  <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">unknown</a>
1428  then the attribute [['''MUST''']] return the  <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>,
1429  [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node.  then the value
1430  Otherwise, it [['''MUST''']] return [CODE(DOM)@en[[[null]]]].  <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>
1431    <em class=rfc2119>MUST</em> be used.</p>
1432  ;; This attribute is analogue to the  
1433  [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute  <div class="note memo">
1434  for [CODE(DOMi)@en[[[ElementTypeDefinition]]]],  <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1435  [CODE(DOMi)@en[[[Entity]]]], and [CODE(DOMi)@en[[[Notation]]]]  created by the
1436  nodes, or the [CODE(DOMa)@en[[[ownerElement]]]]  <a href="#createAttributeDefinition"><code>createAttributeDefinition</code></a>
1437  attribute for [CODE(DOMi)@en[[[Attr]]]] nodes.  method has its <a href="#declaredType"><code>declaredType</code></a> attribute
1438    set to <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</p>
 ** 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>  
1439  </div>  </div>
1440    
1441    <p>If the source of the information does not distinguish
1442    <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">no
1443    value</a> and/or
1444    <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">unknown</a>
1445    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite> and
1446    <code>CDATA</code>
1447    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1448    <a href="#ref-XML11">XML11</a>]</cite>, then the value
1449    <a href="#CDATA_ATTR"><code>CDATA_ATTR</code></a> <em class=rfc2119>MUST</em>
1450    be used.</p>
1451    
1452    <p>In Perl binding
1453    <cite class="bibref normative">[<a href="#ref-DOMPERL">DOMPERL</a>]</cite>, the
1454    <code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the
1455    <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>
1456    definition group.</p>
1457    
1458      </dd>
1459    <dt><dfn id=allowedTokens class=dom-attr><code>allowedTokens</code></dfn> of
1460    type <code>DOMStringList</code>, read$B!>(Bonly</dt>
1461      <dd><p>The list of allowed attribute values.</p>
1462    
1463      <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
1464      <code>DOMStringList</code> object associated to this attribute.  The object
1465      <em class=rfc2119>MAY</em> contain zero or more ordered strings, consist of
1466      zero or more characters respectively, possibly with duplications.  The
1467      object <em class=rfc2119>MUST</em> be read$B!>(Bonly if and only if the node
1468      is <a href="#read-only">read$B!>(Bonly</a>.</p>
1469    
1470      <p>If the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1471      node is created during the process to create a <abbr>DOM</abbr> from an
1472      <abbr>XML</abbr> document, the object <em class=rfc2119>MUST</em> contain
1473      the names or name tokens allowed for the attribute defined by the node.
1474      If the document is well$B!>(Bformed, the object will be empty unless
1475      the <a href="#declaredType"><code>declaredType</code></a> is
1476      <a href="#ENUMERATION_ATTR"><code>ENUMERATION_ATTR</code></a> or
1477      <a href="#NOTATION_ATTR"><code>NOTATION_ATTR</code></a>.</p>
1478    
1479      <p>If the <a href="#declaredType"><code>declaredType</code></a> is different
1480      from <a href="#ENUMERATION_ATTR"><code>ENUMERATION_ATTR</code></a> or
1481      <a href="#NOTATION_ATTR"><code>NOTATION_ATTR</code></a>, this attribute
1482      <em class=rfc2119>MUST</em> be ignored for the purpose of serializing
1483      into (part of) <abbr>XML</abbr> document.</p>
1484    
1485      <div class="note memo">
1486        <p>When serializing the node it should be noted that the object might
1487        be empty, might contain duplications, and might contain strings that are
1488        not names or name tokens.</p>
1489      </div></dd>
1490    <dt><dfn id=defaultType class=dom-attr><code>defaultType</code></dfn> of
1491    type <code>unsigned short</code></dt>
1492      <dd><p>The type of the default for the attribute.  It is expected that this
1493      attribute contains a value from the definition group
1494      <a href="#DefaultValueType"><code>DefaultValueType</code></a>.</p>
1495    
1496      <p>On getting, the attribute <em class=rfc2119>MUST</em> return
1497      the value associated to this attribute.</p>
1498    
1499      <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1500      <code>NO_MODIFICATION_ALLOWED_ERR</code> if the
1501      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1502      is <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it
1503      <em class=rfc2119>MUST</em> set the specified value as the value
1504      associated to this attribute.</p>
1505    
1506      <p>If the
1507      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node is
1508      created during the process to create a <abbr>DOM</abbr> from an
1509      <abbr>XML</abbr> document, an appropriate value from the
1510      <a href="#DefaultValueType"><code>DefaultValueType</code></a> definition
1511      group <em class=rfc2119>MUST</em> be set to the attribute.</p>
1512    
1513      <!-- DefaultValueType -->
1514      <p>The definition group
1515      <dfn id=DefaultValueType><code>DefaultValueType</code></dfn>
1516      contains integers indicating the type of the default for the attribute.
1517      The definition group contains the following constans:</p>
1518    
1519      <table>
1520      <thead>
1521      <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
1522      </thead>
1523      <tbody>
1524      <tr>
1525      <th scope=row><dfn id=UNKNOWN_DEFAULT class=dom-const><code>UNKNOWN_DEFAULT</code></dfn>
1526      <td><code>0</code><td>Unknown.</tr>
1527      <tr>
1528      <th scope=row><dfn id=FIXED_DEFAULT class=dom-const><code>FIXED_DEFAULT</code></dfn>
1529      <td><code>1</code><td>Provided explicitly and only the value is allowed.
1530      <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1531      <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1532      <tr>
1533      <th scope=row><dfn id=REQUIRED_DEFAULT class=dom-const><code>REQUIRED_DEFAULT</code></dfn>
1534      <td><code>2</code><td>No default value and the attribute have to be
1535      explicitly specified.</tr>
1536      <tr>
1537      <th scope=row><dfn id=IMPLIED_DEFAULT class=dom-const><code>IMPLIED_DEFAULT</code></dfn>
1538      <td><code>3</code><td>Implied
1539      <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1540      <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1541      <tr>
1542      <th scope=row><dfn id=EXPLICIT_DEFAULT class=dom-const><code>EXPLICIT_DEFAULT</code></dfn>
1543      <td><code>4</code><td>Provided explicitly.</tr>
1544      </tbody>
1545      </table>
1546    
1547      <p>If the source of the default type does not distinguish
1548      implied and unknown default types, then the value
1549      <a href="#IMPLIED_DEFAULT"><code>IMPLIED_DEFAULT</code></a>
1550      <em class=rfc2119>MUST</em> be used.</p>
1551    
1552      <div class="note memo">
1553      <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1554      node created by the
1555      <a href="#createAttributeDefinition"><code>createAttributeDefinition</code></a>
1556      method has its <a href="#defaultType"><code>defaultType</code></a>
1557      attribute set to
1558      <a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</p>
1559      </div></dd>
1560    </dl>
1561    
1562  </div>  </div>
1563    
1564    <div class=section id=section-entity>
1565    <h3>Modifications to the <code id=Entity>Entity</code> Interface</h3>
1566    
1567    <p>The implementation of the <a href="#Entity"><code>Entity</code></a>
1568    interface <em class=rfc2119>MUST</em> be modified as the following
1569    <a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p>
1570    <pre class=idl><code>// Modifications to the Entity interface
1571      attribute DOMString <a href="#publicId">publicId</a>;
1572      attribute DOMString <a href="#systemId">systemId</a>;
1573      attribute DOMString <a href="#notationName">notationName</a>;
1574    
1575      // Additions to the Entity interface
1576      attribute DOMString <a href="#hasReplacementTree">hasReplacementTree</a>;
1577      readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
1578    
1579      attribute boolean <a href="#isExternallyDeclared">isExternallyDeclared</a>;
1580    </code></pre>
1581    
1582    <p>The <code id=notationName>notationName</code> attribute of the
1583    <a href="#Entity"><code>Entity</code></a> interface is no longer
1584    read$B!>(Bonly.</p>
1585    
1586    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1587    <code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is
1588    <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it <em class=rfc2119>MUST</em>
1589    set the specified value as the value associated to the attribute.  No lexical
1590    validation is performed.  The new value <em class=rfc2119>MAY</em> be
1591    <code>null</code>.</p>
1592    
1593    <dl>
1594    <dt><dfn id=hasReplacementTree class=dom-attr><code>hasReplacementTree</code></dfn>
1595    of type boolean</dt>
1596      <dd><p>Whether the structure of the replacement text of the entity
1597      is available via the <code>NodeList</code> object in the
1598      <code>childNodes</code> attribute of the entity.</p>
1599    
1600      <p>On getting, the attribute <em class=rfc2119>MUST</em> return
1601      the value associated to this attribute.</p>
1602    
1603      <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1604      <code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is
1605      <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it
1606      <em class=rfc2119>MUST</em> set the specified value as the
1607      value associated to this attribute.</p>
1608    
1609      <div class="note memo">
1610      <p>The attribute can be set to <code>false</code> even if the
1611      <a href="#Entity"><code>Entity</code></a> node has any child node.
1612      If the attribute is set to <code>false</code>, then any child node of
1613      the <a href="#Entity"><code>Entity</code></a> node ought to be ignored,
1614      say, for the purpose of serialization.</p>
1615      </div>
1616    
1617      <p>When an <code>EntityReference</code> node is created by cloning
1618      the replacement subtree of the <a href="#Entity"><code>Entity</code></a>
1619      node, if the attribute is set to <code>false</code>, then any descendant
1620      of the node <em class=rfc2119>MUST</em> be ignored.</p>
1621    
1622      <p>If the <a href="#Entity"><code>Entity</code></a> node is created during
1623      the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document,
1624      the following requirements are applied:  If the entity is an unparsed
1625      entity, then the attribute <em class=rfc2119>MUST</em> be set to
1626      <code>false</code>.  Otherwise, if the entity is an external entity whose
1627      replacement text is not available, or whose replacement text is not converted
1628      to a replacement tree, then the attribute <em class=rfc2119>MUST</em> be set
1629      to <code>false</code>.  Otherwise, the attribute
1630      <em class=rfc2119>MUST</em> be set to <code>true</code>.</p>
1631    
1632      <div class="note memo">
1633      <p>An <a href="#Entity"><code>Entity</code></a> node created by the
1634      <a href="#createGeneralEntity"><code>createGeneralEntity</code></a> method
1635      has its <a href="#hasReplacementTree"><code>hasReplacementTree</code></a>
1636      attribute set to <code>false</code>.</p>
1637      </div></dd>
1638    <dt><dfn id=isExternallyDeclared class=dom-attr><code>isExternallyDeclared</code></dfn>
1639    of type boolean</dt>
1640      <dd><p>Whether the entity is declared by an external entity declaration or
1641      not.  If the value is <code>true</code>, the entity is declared in an entity
1642      declaration in the external subset entity or in an external parameter entity.
1643      If the value is <code>false</code>, the entity is declared in an entity
1644      declaration in the internal subset, or the node is created in memory.</p>
1645    
1646      <p>On getting, the attribute <em class=rfc2119>MUST</em> return
1647      the value associated to this attribute.</p>
1648    
1649      <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1650      <code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is
1651      <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it
1652      <em class=rfc2119>MUST</em> set the specified value as the value associated
1653      to this attribute.</p>
1654    
1655      <p>If the <a href="#Entity"><code>Entity</code></a> node is created during
1656      the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document,
1657      the following requirements are applied:  If the entity is an unparsed
1658      entity, then the attribute <em class=rfc2119>MUST</em> be set to
1659      <code>false</code>.  Otherwise, i.e. the entity is a parsed entity, then the
1660      attribute <em class=rfc2119>MUST</em> be set to the value of whether the
1661      entity is declared by an external markup declaration or not.</p></dd>
1662    </dl>
1663    </div>
1664    
1665    <div class=section id=section-notation>
1666    <h3>Modifications to the <code id=Notation>Notation</code> Interface</h3>
1667    
1668    <p>The implementation of the <a href="#Notation"><code>Notation</code></a>
1669    interface <em class=rfc2119>MUST</em> be modified as the following
1670    <a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p>
1671    <pre class=idl><code>// Modifications to the Notation interface
1672      attribute DOMString <a href="#publicId">publicId</a>;
1673      attribute DOMString <a href="#systemId">systemId</a>;
1674    
1675      // Addition to the Notation interface
1676      readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
1677    </code></pre>
1678    </div>
1679    
1680    </div>
1681    
1682  <div id="references" class="section reference">  <div id="references" class="section reference">
1683  <h2>References</h2>  <h2>References</h2>
# Line 781  definition group.</pre> Line 1687  definition group.</pre>
1687    
1688  <dl>  <dl>
1689  <dt id=ref-DOM3CORE>DOM3CORE</dt>  <dt id=ref-DOM3CORE>DOM3CORE</dt>
1690    <dd class=ed>@@ W3C DOM Level 3 Core</dd>    <dd><cite><a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407">Document
1691  <dt id=ref-DOMDTDEF>DOMDTDEF</dt>    Object Model (<abbr>DOM</abbr>) Level 3 Core Specification, Version
1692    <dd class=ed>@@ manakai's extension to DOM for document type definitions</dd>    1.0</a></cite>, <abbr>W3C</abbr> Recommendation, <time datetime=2004-04-07>7
1693      April 2004</time>.  <em>This</em> version of the specification is referenced.
1694      The latest version of the specification is available at
1695      <code class=uri>&lt;<a href="http://www.w3.org/TR/DOM-Level-3-Core">http://www.w3.org/TR/DOM-Level-3-Core</a>></code>.</dd>
1696    <dt id=ref-DOMBIND>DOMBIND</dt>
1697      <dd><cite><a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/">Language
1698      Bindings for <abbr>DOM</abbr> Specifications</a></cite>, <abbr>W3C</abbr>
1699      Working Draft, <time datetime=2007-10-17>17 October 2007</time>.  
1700      <em>This</em> version of the specification is referenced.  The latest version
1701      of the specification is available at
1702      <code class=uri>&lt;<a href="http://www.w3.org/TR/DOM-Bindings/">http://www.w3.org/TR/DOM-Bindings/</a>></code>.</dd>
1703    <dt id=ref-DOMPERL>DOMPERL</dt>
1704      <dd><cite><a href="http://suika.fam.cx/gate/2005/sw/manakai/DOM%20Perl%20Binding">manakai's
1705      <abbr>DOM</abbr> Perl Binding</a></cite>, editor's draft.  Work in
1706      progress.</dd>
1707    <dt id=ref-HTML5>HTML5</dt>
1708      <dd><cite><a href="http://whatwg.org/html5"><abbr>HTML</abbr> 5</a></cite>,
1709      <abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr>
1710      Working Draft.  Work in progress.</dd>
1711    <dt id=ref-INFOSET>INFOSET</dt>
1712      <dd><cite><a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204"><abbr>XML</abbr>
1713      Information Set (Second Edition)</a></cite>, <abbr>W3C</abbr> Recommendation,
1714      <time datetime=2004-02-04>4 February 2004</time>.  <em>This</em> version of
1715      the specification is referenced.  The latest version of the specification is
1716      available at
1717      <code class=uri>&lt;<a href="http://www.w3.org/TR/xml-infoset">http://www.w3.org/TR/xml-infoset</a>></code>.</dd>
1718  <dt id="ref-KEYWORDS">KEYWORDS</dt>  <dt id="ref-KEYWORDS">KEYWORDS</dt>
1719    <dd><cite><a href="urn:ietf:rfc:2119">Key words for use in    <dd><cite><a href="urn:ietf:rfc:2119">Key words for use in
1720    <abbr>RFCs</abbr> to Indicate Requirement Levels</a></cite>,    <abbr>RFCs</abbr> to Indicate Requirement Levels</a></cite>,
# Line 792  definition group.</pre> Line 1723  definition group.</pre>
1723    14</a>, <abbr title="Request for Comments">RFC</abbr> 2119,    14</a>, <abbr title="Request for Comments">RFC</abbr> 2119,
1724    <time datetime=1997-03>March 1997</time>.    <time datetime=1997-03>March 1997</time>.
1725    <em>This</em> version of the specification is referenced.</dd>    <em>This</em> version of the specification is referenced.</dd>
1726  <dt id=ref-INFOSET>INFOSET</dt>  <dt id=ref-MANAKAI>MANAKAI</dt>
1727    <dd class=ed>@@</dd>    <dd><cite><a href="http://suika.fam.cx/gate/2005/sw/manakai/DOM%20Extensions">
1728      manakai's <abbr>DOM</abbr> Extensions</a></cite>, editor's draft.  Work in
1729      progress.</dd>
1730  <dt id=ref-XML10">XML10</dt>  <dt id=ref-XML10">XML10</dt>
1731    <dd><cite><a href="http://www.w3.org/TR/2006/REC-xml-20060816">Extensible    <dd><cite><a href="http://www.w3.org/TR/2006/REC-xml-20060816">Extensible
1732    Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>,    Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>,
1733    <abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August    <abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August
1734    2006</time>, edited in place <time datetime=2006-09-29>29 September    2006</time>, edited in place <time datetime=2006-09-29>29 September
1735    2006</time>.  Tje latest version of the specification is available at    2006</time>.  <em>This</em> version of the specification is referenced.  The
1736    <code class=uri>&lt;<a href="http://www.w3.org/TR/xml">http://www.w3.org/TR/xml</a>&gt;</code>.    latest version of the specification is available at
1737    <em>This</em> version of the specification is referenced.</dd>    <code class=uri>&lt;<a href="http://www.w3.org/TR/xml">http://www.w3.org/TR/xml</a>&gt;</code>.</dd>
1738  <dt id=ref-XML11>XML11</dt>  <dt id=ref-XML11>XML11</dt>
1739    <dd class=ed>@@</dd>    <dd><cite><a href="http://www.w3.org/TR/2006/REC-xml11-20060816/">Extensible
1740      Markup Language (<abbr>XML</abbr>) 1.1 (Second Edition)</a></cite>,
1741      <abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August
1742      2006</time>, edited in place <time datetime=2006-09-29>29 September
1743      2006</time>.  <em>This</em> version of the specification is referenced.  The
1744      latest version of the specification is available at
1745      <code class=uri>&lt;<a href="http://www.w3.org/TR/xml11">http://www.w3.org/TR/xml11</a>></code>.</dd>
1746  </dl>  </dl>
1747  </div>  </div>
1748    
1749  <div id="informative-references" class="section informative reference">  <div id="informative-references" class="section informative reference">
1750  <h3>Non$B!>(Bnormative References</h3>  <h3>Non$B!>(Bnormative References</h3>
1751    
1752  <dl class=ed>  <dl>
1753  <dt id=ref-CSS>CSS</dt>  <dt id=ref-DOM1WD>DOM1WD</dt>
1754    <dd><cite><a href="http://www.w3.org/TR/2007/CR-CSS21-20070719">Cascading    <dd><cite><a href="http://www.w3.org/TR/WD-DOM-971209/">Document Object
1755    Style Sheets Level 2 Revision 1 (<abbr>CSS</abbr> 2.1)    Model Specification</a></cite>, <abbr>W3C</abbr> Working Draft,
1756    Specification</a></cite>,    <time datetime=1997-12-09>9 December 1998</time>.</dd>
1757    <abbr title="World Wide Web Consortium">W3C</abbr> Candidate    <dd><cite><a href="http://www.w3.org/TR/WD-DOM-19980318/">Document Object
1758    Recommendation, <time datetime=2007-07-19>19 July 2007</time>.    Model Specification</a></cite>, <abbr>W3C</abbr> Working Draft,
1759    Work in progress.  The latest version of the specification is    <time datetime=1998-03-18>18 March 1998</time>.</dd>
1760    available at    <dd><cite><a href="http://www.w3.org/TR/1998/WD-DOM-19980416/">Document
1761    <code class=URI>&lt;<a href="http://www.w3.org/TR/CSS21">http://www.w3.org/TR/CSS21</a>></code>.</dd>    Object Model Specification, Version 1.0</a></cite>, <abbr>W3C</abbr> Working
1762  <dt id=ref-CSSOM>CSSOM</dt>    Draft, <time datetime=1998-04-16>16 April 1998</time>.</dd>
1763    <dd><cite><a href="http://dev.w3.org/cvsweb/~checkout~/csswg/cssom/Overview.html?rev=1.55&amp;content-type=text/html;%20charset=utf-8">Cascading  <dt id=ref-DOM3AS>DOM3AS</dt>
1764    Style Sheets Object Model (<abbr>CSSOM</abbr>)</a></cite>,    <dd><cite><a href="http://www.w3.org/TR/2002/NOTE-DOM-Level-3-AS-20020725/">Document
1765    <abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft,    Object Model (<abbr>DOM</abbr>) Level 3 Abstract Schemas Specification,
1766    <time datetime=2007-06-18>18 June 2007</time>.  Work in progress.    Version 1.0</a></cite>, <abbr>W3C</abbr> Note, <time datetime=2002-07-25>25
1767    The latest Editor's Draft of the specification is available at    July 2002</time>.  The latest version of the specification is available at
1768    <code class=URI>&lt;<a href="http://dev.w3.org/csswg/cssom/Overview.html">http://dev.w3.org/csswg/cssom/Overview.html</a>></code>.</dd>    <code class=uri>&lt;<a href="http://www.w3.org/TR/DOM-Level-3-AS">http://www.w3.org/TR/DOM-Level-3-AS</a>></code>.</dd>
1769  <dt id=ref-HTML5>HTML5</dt>  <dt id=ref-XSAPI>XSAPI</dt>
1770    <dd><cite><a href="http://whatwg.org/html5"><abbr>HTML</abbr> 5</a></cite>,    <dd><cite><a href="http://www.w3.org/Submission/2004/SUBM-xmlschema-api-20040309/"><abbr>XML</abbr>
1771    <abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr>    Schema <abbr>API</abbr></a></cite>, <abbr>W3C</abbr> Member Submission,
1772    Working Draft.  Work in progress.</dd>    <time datetime=2004-03-09>9 March 2004</time>.  The latest version of the
1773  <dt id=ref-SAPI>SAPI</dt>    specification is available at
1774    <dd><cite><a href="http://dev.w3.org/cvsweb/~checkout~/2006/webapi/selectors-api/Overview.html?rev=1.28&amp;content-type=text/html;%20charset=utf-8">Selectors <abbr>API</abbr></a></cite>,    <code class=uri>&lt;<a href="http://www.w3.org/Submission/xmlschema-api/">http://www.w3.org/Submission/xmlschema-api/</a>></code>.</dd>
   <abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft,  
   <time datetime=2007-08-29>29 August 2007</time>.  Work in progress.  
   The latest Editor's Draft of the specification is available at  
   <code class=URI>&lt;<a href="http://dev.w3.org/2006/webapi/selectors-api/Overview.html">http://dev.w3.org/2006/webapi/selectors-api/Overview.html</a>></code>.  
   The latest published version of the specification is available at  
   <code class=URI>&lt;<a href="http://www.w3.org/TR/selectors-api/">http://www.w3.org/TR/selectors-api/</a>></code>.</dd>  
 <dt id=XBL2>XBL2</dt>  
   <dd><cite><a href="http://www.mozilla.org/projects/xbl/xbl2.html"><abbr>XBL</abbr>  
   2.0</a></cite>, Mozilla.org, <time datetime=2007-03-15>15 Mar 2007</time>.  
   Work in progress.  The latest  
   <abbr title="World Wide Web Consortium">W3C</abbr>$B!>(Bpublished  
   version of the specification is available at  
   <code class=URI>&lt;<a href="http://www.w3.org/TR/xbl/">http://www.w3.org/TR/xbl/</a>></code>.</dd>  
 <dt id=ref-XML5>XML5</dt>  
   <dd class=ed>@@</dd>  
1775  </dl>  </dl>
1776  </div>  </div>
1777    

Legend:
Removed from v.1.4  
changed lines
  Added in v.1.25

admin@suikawiki.org
ViewVC Help
Powered by ViewVC 1.1.24