/[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.14 by wakaba, Tue Dec 4 10:27:26 2007 UTC revision 1.19 by wakaba, Wed Dec 5 07:38:14 2007 UTC
# Line 10  Line 10 
10    
11  <div class="header">  <div class="header">
12  <h1>DOM Document Type Definition Module</h1>  <h1>DOM Document Type Definition Module</h1>
13  <h2>Working Draft <time datetime=2007-12-03>3 December 2007</time></h2>  <h2>Working Draft <time datetime=2007-12-05>5 December 2007</time></h2>
14    
15  <dl class="versions-uri">  <dl class="versions-uri">
16  <dt>This Version</dt>  <dt>This Version</dt>
# Line 129  interface.</p> Line 129  interface.</p>
129  <p>If the <code>strictErrorChecking</code> attribute of the  <p>If the <code>strictErrorChecking</code> attribute of the
130  <code>Document</code> node is <code>false</code>, the methods are  <code>Document</code> node is <code>false</code>, the methods are
131  not required to raise exceptions <span class=ed>[DOM3]</span>.</p>  not required to raise exceptions <span class=ed>[DOM3]</span>.</p>
132    
133    <div class=ed>
134    <p>Conformant product classes: implementation, XML parser (XML document ->
135    DOM converter), XML serializer (DOM -> XML document covnerter).
136    XML Infoset -> DOM converter, and DOM -> XML Infoset converter.</p>
137    </div>
138  </div>  </div>
139    
140  <div class=section id=dom-dtdef>  <div class=section id=dom-dtdef>
# Line 158  consists of three interfaces:</p> Line 164  consists of three interfaces:</p>
164  the <abbr>DOM</abbr> Document Type Definition module, the  the <abbr>DOM</abbr> Document Type Definition module, the
165  <code>hasFeature</code> method of a <code>DOMImplementation</code> object  <code>hasFeature</code> method of a <code>DOMImplementation</code> object
166  <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
167  set to <code>http://suika.fam.cx/www/2006/feature/XDoctype</code> and  set to
168  <code>3.0</code> respectively.</p>  <dfn id=feature-XDoctype><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></dfn>
169    and <dfn id=feature-XDoctype-3.0><code>3.0</code></dfn> respectively.</p>
170    
171  <p>In such an implementation, the <code>getFeature</code> method of a  <p>In such an implementation, the <code>getFeature</code> method of a
172  <code>Document</code> object <em class=rfc2119>MUST</em> return the (at least  <code>Document</code> object <em class=rfc2119>MUST</em> return the (at least
173  conceptually) same object implementing the  conceptually) same object implementing the
174  <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface when  <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface when
175  the parameters are set to  the parameters are set to
176  <code>http://suika.fam.cx/www/2006/feature/XDoctype</code> and  <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
177  <code>3.0</code> respectively.  Likewise, any method that takes one or more  and <a href="#feature-XDoctype-3.0"><code>3.0</code></a> respectively.  
178  feature names with or without version number, including the methods  Likewise, any method that takes one or more feature names with or without
179  <code>hasFeature</code> and <code>getFeature</code>,  version number, including the methods <code>hasFeature</code> and
180  <em class=rfc2119>MUST</em> behave in a manner consistent with the  <code>getFeature</code>, <em class=rfc2119>MUST</em> behave in a manner
181  aforementioned cases.</p>  consistent with the aforementioned cases.</p>
182  </div>  </div>
183    
184  <div class=section id=section-node>  <div class=section id=section-node>
185  <h3>Modifications to the <code id=Node>Node</code> Interface</h3>  <h3>Modifications to the <code id=Node>Node</code> Interface</h3>
186    
187    <p>The implementation of the
188    <a href="#Node"><code>Node</code></a> interface
189    <em class=rfc2119>MUST</em> be modified as following:</p>
190  <pre class=idl><code>// Additions to the Node interface  <pre class=idl><code>// Additions to the Node interface
191    
192  // Additions to the NodeType definition group  // Additions to the NodeType definition group
# Line 197  these kinds of nodes, methods and attrib Line 207  these kinds of nodes, methods and attrib
207  <a href="#Node"><code>Node</code></a> interface must behave as following:</p>  <a href="#Node"><code>Node</code></a> interface must behave as following:</p>
208    
209  <dl>  <dl>
210    <dt><code id=attributes>attributes</code></dt>
211      <dd>
212        <p>On getting, the attribute <em class=rfc2119>MUST</em> return
213        <code>null</code>.</p>
214      </dd>
215    <dt><code id=baseURI>baseURI</code></dt>
216      <dd>
217        <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
218        value of the <a href="#baseURI"><code>baseURI</code></a> attribute
219        of the node in the <code>ownerDocument</code> attribute of the node.
220        Note that the value might be <code>null</code>.</p>
221      </dd>
222    <dt><code id=isEqualNode>isEqualNode</code></dt>
223      <dd><p>For the <a href="#isEqualNode"><code>isEqualNode</code></a> method,
224      following items are added to the list of conditions for equality:</p>
225    
226      <ul>
227      <li>
228        <p>If the nodes are <a href="#DocumentType"><code>DocumentType</code></a>
229        and at least one of them has the support for the feature
230        <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>:</p>
231        <ul>
232        <li>they are equal according to <abbr>DOM</abbr> level 3 definition
233        <span class=ed>@@ ref</span>, and
234        <li>either:
235          <ul><!--
236          <li>both of them does not support the feature
237          <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>,</li>-->
238          <li>exactly one of them support the feature
239          <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
240          and the <code>length</code> attribute of the <code>NamedNodeMap</code>
241          object in the <a href="#elementTypes"><code>elementTypes</code></a>
242          attribute of it is equal to <code>0</code>, or</li>
243          <li>both of them support the feature
244          <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
245          and the values of the
246          <a href="#elementTypes"><code>elementTypes</code></a> attributes are
247          equal (equality of the
248          <a href="#elementTypes"><code>elementTypes</code></a> attribute is same
249          as that for the <code>attributes</code> attribute).</li>
250          </ul>
251        </li>
252        </ul>
253      </li>
254    
255      <li><p>If the nodes are
256      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
257      the values of the
258      <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
259      attributes are equal (equality of the
260      <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
261      attribute is same as that for the <code>attributes</code> attribute).</p></li>
262    
263      <li><p>If the nodes are
264      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>,
265      the values of the <a href="#declaredType"><code>declaredType</code></a> and
266      the <a href="#defaultType"><code>defaultType</code></a> attributes are
267      equal respectively.</p></li>
268    
269      <li><p>If the nodes are
270      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>,
271      the values of the <code>DOMStringList</code> objects in the
272      <a href="#allowedTokens"><code>allowedTokens</code></a> attributes
273      are equal, i.e. their <code>length</code> attribute values are equal and
274      each string exists in a list is contained in another list (their indeces
275      may be different), with an additional constraint that the number of the
276      items that are equal to a string in a list is equal to the number
277      of the items equal to the string in another list.</p></li>
278      </ul></dd>
279    <dt><code id=nodeName>nodeName</code></dt>
280      <dd>
281        <p>If the node is an
282        <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
283        On getting, the attribute <em class=rfc2119>MUST</em> return the
284        name of the element type definition represented by the node.</p>
285    
286        <p>If the node is an
287        <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:
288        On getting, the attribute <em class=rfc2119>MUST</em> return the
289        name of the attribute definition represented by the node.</p>
290      </dd>
291  <dt><code id=nodeType>nodeType</code></dt>  <dt><code id=nodeType>nodeType</code></dt>
292    <dd>    <dd>
293      <p>On getting, the attribute <em class=rfc2119>MUST</em> return      <p>On getting, the attribute <em class=rfc2119>MUST</em> return
# Line 227  following:</p> Line 318  following:</p>
318  </tbody>  </tbody>
319  </table>  </table>
320    </dd>    </dd>
321    <dt><code id=nodeValue>nodeValue</code> and
322    <code id=textContent>textContent</code></dt>
323      <dd>
324        <p>If the node is an
325        <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
326        On getting, the attributes <em class=rfc2119>MUST</em> return the
327        name of the element type.</p>
328    
329        <div class="note memo">
330          <p>Thus, on setting the attributes does nothing
331          <span class=ed>[DOM3]</span>.</p>
332        </div>
333    
334        <p>On setting, the <a href="#textContent"><code>textContent</code></a>
335        attribute <em class=rfc2119>MUST NOT</em> raise a
336        <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>.
337        <span class=ed>@@ I forgot why this requirement is necessary.</span></p>
338    
339        <p>If the node is an
340        <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:</p>
341    
342        <pre class=ed>
343    The getter of the [CODE(DOMa)@en[[[nodeValue]]]] attribute
344    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
345    [['''MUST''']] return the normalized default value
346    of the attribute.
347    
348    @@
349    
350    [4] The getter of the [CODE(DOMa)@en[[[textContent]]]]
351    attribute of an [CODE(DOMi)@en[[[AttributeDefinition]]]]
352    object [['''MUST''']] behave as if it were an
353    [CODE(DOMi)@en[[[Attr]]]] object.
354    
355    The setter of the [CODE(DOMa)@en[[[textContent]]]] attribute
356    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
357    [['''MUST''']] behave as if the following algorithm
358    is performed:
359    = If the [CODE(DOMi)@en[[[AttributeDefinition]]]]
360    object is read-only, then throw an
361    [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].
362    = Remove any child node the node has.
363    = If the new value is not empty and not [CODE(IDL)@en[[[null]]]],
364    then create a [CODE(DOMi)@en[[[Text]]]] node
365    whose [CODE(DOMa)@en[[[data]]]] is the new value
366    and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].
367    </pre>
368      </dd>
369  <dt class=ed>@@ ...</dt>  <dt class=ed>@@ ...</dt>
370  </dl>  </dl>
371    
# Line 235  following:</p> Line 374  following:</p>
374  <div class=section id=section-documentxdoctype>  <div class=section id=section-documentxdoctype>
375  <h3>The <code>DocumentXDoctype</code> Interface</h3>  <h3>The <code>DocumentXDoctype</code> Interface</h3>
376    
377    <p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface
378    <em class=rfc2119>MUST</em> be implemented as following:</p>
379  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {
380    DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>    DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>
381      (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)      (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)
# Line 389  method</dt> Line 530  method</dt>
530      <code>manakaiEntityBaseURI</code>, and      <code>manakaiEntityBaseURI</code>, and
531      <code>manakaiEntityURI</code> <span class=ed>@@ ref</span></dt>      <code>manakaiEntityURI</code> <span class=ed>@@ ref</span></dt>
532        <dd>No explicit value is set.</dd>        <dd>No explicit value is set.</dd>
533      <dt><code>manakaiHasReplacementTree</code> and      <dt><a href="#hasReplacementTree"><code>hasReplacementTree</code></a> and
534      <code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>      <code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
535        <dd><code>false</code>.</dd>        <dd><code>false</code>.</dd>
536      <dt><code>nodeName</code></dt>      <dt><code>nodeName</code></dt>
# Line 463  define it for <code>Document</code> meth Line 604  define it for <code>Document</code> meth
604    
605  </div>  </div>
606    
607    
608    <div class=section id=section-documenttype>
609    <h3>Modifications to the <code id=DocumentType>DocumentType</code>
610    Interface</h3>
611    
612    <p>A <a href="#DocumentType"><code>DocumentType</code></a> interface
613    <em class=rfc2119>MAY</em> contain zero or more
614    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
615    nodes in the <code>NodeList</code> object contained in the
616    <code>childNodes</code> attribute of the
617    <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
618    
619    <p>If the <a href="#DocumentType"><code>DocumentType</code></a> node is created
620    during the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr>
621    document, the <code>NodeList</code> object in the <code>childNodes</code>
622    object <em class=rfc2119>MUST</em> contains the
623    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
624    nodes representing the processing instructions in the document type
625    definition of the document processed <span class=ed>@@ ref</span> by
626    the <abbr>XML</abbr> processor.  If the
627    <a href="#DocumentType"><code>DocumentType</code></a> node is marked
628    as read$B!>(Bonly, then all the child nodes <em class=rfc2119>MUST</em>
629    also be marked as read$B!>(Bonly.</p>
630    
631    <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is created
632    from a document type declaration information item <span class=ed>@@ ref</span>,
633    the <code>NodeList</code> object in the <code>childNodes</code> attribute
634    of the node <em class=rfc2119>MUST</em> contain the
635    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes
636    created from the processing instruction information items in the list in the
637    [children] property of the document type declaration item in the same
638    order.</p>
639    
640    <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is mapped to
641    a document type declaration information item, the list in the [children]
642    property <em class=rfc2119>MUST</em> contain the processng instruction
643    information items created from the
644    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes
645    in the <code>NodeList</code> object in the <code>childNodes</code> attribute
646    of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
647    
648    <p>The implementation of the
649    <a href="#DocumentType"><code>DocumentType</code></a> interface
650    <em class=rfc2119>MUST</em> be modified as following:</p>
651    <pre class=idl><code>// Modifications to the DocumentType interface
652      attribute DOMString <a href="#publicId">publicId</a>;
653      attribute DOMString <a href="#systemId">systemId</a>;
654    
655      attribute DOMString <a href="#internalSubset">internalSubset</a>;
656    </code></pre>
657    
658    <p>The <code id=publicId>publicId</code> attribute and the
659    <code id=systemId>systemId</code> attribute of
660    <a href="#DocumentType"><code>DocumentType</code></a>,
661    <a href="#Entity"><code>Entity</code></a>, and
662    <a href="#Notation"><code>Notation</code></a> interfaces are no longer
663    read$B!>(Bonly.</p>
664    
665    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
666    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
667    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.  
668    Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value
669    associated to the attribute.  No normalization, relative reference resolution,
670    or lexical validation is performed. <span class=ed>@@ If the new
671    value is <code>null</code>, ...</span></p>
672    
673    <div class="note memo">
674    <p>Setting an invalid identifier might make the node unserializable.
675    Setting a public identifier while leaveing system identifier unspecified
676    would also make the <a href="#DocumentType"><code>DocumentType</code></a>
677    or <a href="#Entity"><code>Entity</code></a> node unserializable.</p>
678    </div>
679    
680    <div class=ed>
681    <p>ISSUE: In HTML5, Firefox 1.5, and Opera 9, not specifying public or system identifier results in empty strings.</p>
682    </div>
683    
684    <p>The <code id=internalSubset>internalSubset</code> attribute of the
685    <a href="#DocumentType"><code>DocumentType</code></a> interface is no longer
686    read$B!>(Bonly.</p>
687    
688    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
689    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
690    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.  
691    Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value
692    associated to the attribute.  No normalization, or lexical validation is
693    performed. <span class=ed>@@ If the new value is <code>null</code>,
694    ...</span></p>
695    
696    </div>
697    
698  <div class=section id=section-documenttypedefinition>  <div class=section id=section-documenttypedefinition>
699  <h3>The <code>DocumentTypeDefinition</code> Interface</h3>  <h3>The <code>DocumentTypeDefinition</code> Interface</h3>
700    
701    <div class="note memo">
702    <p>This interface is a separated interface from the
703    <a href="#DocumentType"><code>DocumentType</code></a>, not a set of extensions
704    to the <a href="#DocumentType"><code>DocumentType</code></a>,
705    for the historical reason.</p>
706    </div>
707    
708    <p>The
709    <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
710    interface <em class=rfc2119>MUST</em> be implemented as following:</p>
711  <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {  <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {
712    readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>;    readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>;
713    readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>;    readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>;
# Line 613  reflected by that of the object. Line 855  reflected by that of the object.
855  <div class=section id=section-elementtypedefinition>  <div class=section id=section-elementtypedefinition>
856  <h3>The <code>ElementTypeDefinition</code> Interface</h3>  <h3>The <code>ElementTypeDefinition</code> Interface</h3>
857    
858    <p>The nodes of type
859    <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>
860    represents an element type definition.  Such a node implements the
861    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
862    interface, which extends the <a href="#Node"><code>Node</code></a>
863    interface.</p>
864    
865    <p>An element type definition represents a definition of the element type.
866    It is corresponding to the element type declaration in <abbr>DTD</abbr>.
867    However, an
868    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
869    does not represent the element type definition in <abbr>DTD</abbr> itself.  
870    Even if there are more than one element type declarations for an element type
871    in <abbr>DTD</abbr>, the result <abbr>DOM</abbr> will contain only an
872    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
873    node for that element type.  In addition, if there are attribute definition
874    declarations for an element type, even when there is no element type
875    declaration for that element type, the <abbr>DOM</abbr> will contain an
876    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
877    node for that element type.</p>
878    
879    <p>The <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
880    interface <em class=rfc2119>MUST</em> be implemented as following:</p>
881  <pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> : <a href="#Node">Node</a> {  <pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> : <a href="#Node">Node</a> {
882    readonly attribute <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;    readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
883    
884    <span class=ed>@@ more</span>    <span class=ed>@@ more</span>
885  }</code></pre>  }</code></pre>
886    
887  <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members  <dl>
888    <dt><dfn id=ownerDocumentTypeDefinition class=dom-attr><code>ownerDocumentTypeDefinition</code></dfn>
889  [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute  of type <a href="#DocumentType"><code>DocumentType</code></a>, read$B!>(Bonly</dt>
890  of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object    <dd><p>The
891  [['''MUST''']] return [CODE(IDL)@en[[[null]]]].    <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
892      attribute of
893  [4] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
894  of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object    <a href="#Entity"><code>Entity</code></a>, and
895  [['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]    <a href="#Notation"><code>Notation</code></a> interface contains the
896  of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the    <a href="#DocumentType"><code>DocumentType</code></a> node to which the node
897  [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object.    is attached.</p>
898  Note that it might be [CODE(IDL)@en[[[null]]]].  
899      <p>On getting, the attribute <em class=rfc2119>MUST</em> return a
900  [1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute    <a href="#DocumentType"><code>DocumentType</code></a> node.  It
901  of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object    <em class=rfc2119>MUST</em> be such a node that whose
902  [['''MUST''']] return the name of the element type.    <a href="#elementTypes"><code>elementTypes</code></a> (for an
903      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
904  [2] The getters of the [CODE(DOMa)@en[[[nodeValue]]]]    node), <a href="#entities"><code>entities</code></a> (for an
905  and [CODE(DOMa)@en[[[textContent]]]] attributes    <a href="#Entity"><code>Entity</code></a> node), or
906  of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]    <a href="#notations"><code>notations</code></a> (for a
907  object [['''MUST''']] return [CODE(IDL)@en[[[null]]]].    <a href="#Notation"><code>Notation</code></a> node) attribute contains the
908      <code>NamedNodeMap</code> object that contains the node.  If there is no such
909  ;; Thus, the setter of these attributes do nothing.    a <a href="#DocumentType"><code>DocumentType</code></a> node,
910      then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p></dd>
911  The setter of the [CODE(DOMa)@en[[[textContent]]]]  </dl>
 attribute of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]  
 object [['''MUST NOT''']] throw a  
 [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].  
   
 ** The [CODE(DOMi)@en[ElementTypeDefinition]] Interface  
   
 [5] The  
 [DFN@en[[CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute]]  
 of the [CODE(DOMi)@en[[[ElementTypeDefinition]]]]  
 interface is defined in [[manakai//DOM Extensions]>>50].</pre>  
912  </div>  </div>
913    
914  <div class=section id=section-attributedefinition>  <div class=section id=section-attributedefinition>
915  <h3>The <code>AttributeDefinition</code> Interface</h3>  <h3>The <code>AttributeDefinition</code> Interface</h3>
916    
917    <p>The nodes of type
918    <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>
919    represents an attribute definition.  Such a node implements the
920    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> interface,
921    which extends the <a href="#Node"><code>Node</code></a> interface.</p>
922    
923    <p>An attribute definition represents a definition of the attribute
924    associated to an element type.  It is corresponding to the attribute definition
925    in the attribute list declaration in <abbr>DTD</abbr>.  However, an
926    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node does
927    not represent the attribute definition in <abbr>DTD</abbr> itself.  Even if
928    there are more than one attribute definitions for an attribute of an element
929    type in <abbr>DTD</abbr>, the result <abbr>DOM</abbr> will contain only an
930    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node for
931    that attribute.</p>
932    
933    <p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
934    interface <em class=rfc2119>MUST</em> be implemented as following:</p>
935  <pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> : <a href="#Node">Node</a> {  <pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> : <a href="#Node">Node</a> {
936    <span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span>    <span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span>
937    const unsigned short <a href="#NO_TYPE_ATTR">NO_TYPE_ATTR</a> = 0;    const unsigned short <a href="#NO_TYPE_ATTR">NO_TYPE_ATTR</a> = 0;
# Line 673  interface is defined in [[manakai//DOM E Line 946  interface is defined in [[manakai//DOM E
946    const unsigned short <a href="#NOTATION_ATTR">NOTATION_ATTR</a> = 9;    const unsigned short <a href="#NOTATION_ATTR">NOTATION_ATTR</a> = 9;
947    const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10;    const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10;
948    const unsigned short <a href="#UNKNOWN_ATTR">UNKNOWN_ATTR</a> = 11;    const unsigned short <a href="#UNKNOWN_ATTR">UNKNOWN_ATTR</a> = 11;
949    
950      <span class=comment>// <a href="#DefaultValueType">DefaultValueType</a></span>
951      const unsigned short <a href="#UNKNOWN_DEFAULT">UNKNOWN_DEFAULT</a> = 0;
952      const unsigned short <a href="#FIXED_DEFAULT">FIXED_DEFAULT</a> = 1;
953      const unsigned short <a href="#REQUIRED_DEFAULT">REQUIRED_DEFAULT</a> = 2;
954      const unsigned short <a href="#IMPLIED_DEFAULT">IMPLIED_DEFAULT</a> = 3;
955      const unsigned short <a href="#EXPLICIT_DEFAULT">EXPLICIT_DEFAULT</a> = 4;
956        
957    readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;    readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;
958    
# Line 682  interface is defined in [[manakai//DOM E Line 962  interface is defined in [[manakai//DOM E
962    <span class=ed>...</span>    <span class=ed>...</span>
963  }</code></pre>  }</code></pre>
964    
 <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members  
   
 [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute  
 of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  
 [['''MUST''']] return [CODE(IDL)@en[[[null]]]].  
   
 [9] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute  
 of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  
 [['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]  
 of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the  
 [CODE(DOMi)@en[[[AttributeDefinition]]]] object.  
 Note that it might be [CODE(IDL)@en[[[null]]]].  
   
 [1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute  
 of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  
 [['''MUST''']] return the name of the attribute.  
   
 [2] The getter of the [CODE(DOMa)@en[[[nodeValue]]]] attribute  
 of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  
 [['''MUST''']] return the normalized default value  
 of the attribute.  
   
 @@  
   
 [4] The getter of the [CODE(DOMa)@en[[[textContent]]]]  
 attribute of an [CODE(DOMi)@en[[[AttributeDefinition]]]]  
 object [['''MUST''']] behave as if it were an  
 [CODE(DOMi)@en[[[Attr]]]] object.  
   
 The setter of the [CODE(DOMa)@en[[[textContent]]]] attribute  
 of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  
 [['''MUST''']] behave as if the following algorithm  
 is performed:  
 = If the [CODE(DOMi)@en[[[AttributeDefinition]]]]  
 object is read-only, then throw an  
 [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].  
 = Remove any child node the node has.  
 = If the new value is not empty and not [CODE(IDL)@en[[[null]]]],  
 then create a [CODE(DOMi)@en[[[Text]]]] node  
 whose [CODE(DOMa)@en[[[data]]]] is the new value  
 and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].  
 </pre>  
   
965  <dl>  <dl>
966  <dt><dfn id=ownerElementTypeDefinition class=dom-attr><code>ownerElementTypeDefinition</code></dfn>  <dt><dfn id=ownerElementTypeDefinition class=dom-attr><code>ownerElementTypeDefinition</code></dfn>
967  of type  of type
# Line 917  type <code>unsigned short</code></dt> Line 1154  type <code>unsigned short</code></dt>
1154    
1155  </div>  </div>
1156    
1157  <div class=section id=section-documenttype>  <div class=section id=section-entity>
1158  <h3>Modifications to the <code id=DocumentType>DocumentType</code>  <h3>Modifications to the <code id=Entity>Entity</code> Interface</h3>
 Interface</h3>  
   
 <p>A <a href="#DocumentType"><code>DocumentType</code></a> interface  
 <em class=rfc2119>MAY</em> contain zero or more  
 <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>  
 nodes in the <code>NodeList</code> object contained in the  
 <code>childNodes</code> attribute of the  
 <a href="#DocumentType"><code>DocumentType</code></a> node.</p>  
   
 <p>If the <a href="#DocumentType"><code>DocumentType</code></a> node is created  
 during the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr>  
 document, the <code>NodeList</code> object in the <code>childNodes</code>  
 object <em class=rfc2119>MUST</em> contains the  
 <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>  
 nodes representing the processing instructions in the document type  
 definition of the document processed <span class=ed>@@ ref</span> by  
 the <abbr>XML</abbr> processor.  If the  
 <a href="#DocumentType"><code>DocumentType</code></a> node is marked  
 as read$B!>(Bonly, then all the child nodes <em class=rfc2119>MUST</em>  
 also be marked as read$B!>(Bonly.</p>  
1159    
1160  <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is created  <p>The implementation of the <a href="#Entity"><code>Entity</code></a>
1161  from a document type declaration information item <span class=ed>@@ ref</span>,  interface <em class=rfc2119>MUST</em> be modified as following:</p>
1162  the <code>NodeList</code> object in the <code>childNodes</code> attribute  <pre class=idl><code>// Modifications to the Entity interface
 of the node <em class=rfc2119>MUST</em> contain the  
 <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes  
 created from the processing instruction information items in the list in the  
 [children] property of the document type declaration item in the same  
 order.</p>  
   
 <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is mapped to  
 a document type declaration information item, the list in the [children]  
 property <em class=rfc2119>MUST</em> contain the processng instruction  
 information items created from the  
 <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes  
 in the <code>NodeList</code> object in the <code>childNodes</code> attribute  
 of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>  
   
 <pre class=idl><code>// Modifications to the DocumentType interface  
1163    attribute DOMString <a href="#publicId">publicId</a>;    attribute DOMString <a href="#publicId">publicId</a>;
1164    attribute DOMString <a href="#systemId">systemId</a>;    attribute DOMString <a href="#systemId">systemId</a>;
1165      attribute DOMString <a href="#notationName">notationName</a>;
1166    
1167    attribute DOMString <a href="#internalSubset">internalSubset</a>;    // Additions to the Entity interface
1168      attribute DOMString <a href="#hasReplacementTree">hasReplacementTree</a>;
1169      readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
1170  </code></pre>  </code></pre>
1171    
1172  <p>The <code id=publicId>publicId</code> attribute and the  <p>The <code id=notationName>notationName</code> attribute of the
1173  <code id=systemId>systemId</code> attribute of  <a href="#Entity"><code>Entity</code></a> interface is no longer
 <a href="#DocumentType"><code>DocumentType</code></a>,  
 <a href="#Entity"><code>Entity</code></a>, and  
 <a href="#Notation"><code>Notation</code></a> interfaces are no longer  
1174  read$B!>(Bonly.</p>  read$B!>(Bonly.</p>
1175    
1176  <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a  <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1177  <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>  <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
1178  exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.
1179  Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value  Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value
1180  associated to the attribute.  No normalization, relative reference resolution,  associated to the attribute.  No lexical validation is performed.  The new
1181  or lexical validation is performed. <span class=ed>@@ If the new  value <em class=rfc2119>MAY</em> be <code>null</code>.</p>
 value is <code>null</code>, ...</span></p>  
1182    
1183  <div class="note memo">  <dl>
1184  <p>Setting an invalid identifier might make the node unserializable.  <dt><dfn id=hasReplacementTree class=dom-attr><code>hasReplacementTree</code></dfn>
1185  Setting a public identifier while leaveing system identifier unspecified  of type boolean</dt>
1186  would also make the <a href="#DocumentType"><code>DocumentType</code></a>    <dd><p>Whether the structure of the replacement text of the entity
1187  or <a href="#Entity"><code>Entity</code></a> node unserializable.</p>    is available via the <code>NodeList</code> object in the
1188  </div>    <code>childNodes</code> attribute of the entity.</p>
1189    
1190  <div class=ed>    <p>On getting, the attribute <em class=rfc2119>MUST</em> return
1191  <p>ISSUE: In HTML5, Firefox 1.5, and Opera 9, not specifying public or system identifier results in empty strings.</p>    the value associated to this attribute.</p>
 </div>  
1192    
1193  <p>The <code id=internalSubset>internalSubset</code> attribute of the    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1194  <a href="#DocumentType"><code>DocumentType</code></a> interface is no longer    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
1195  read$B!>(Bonly.</p>    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.  
1196      Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the
1197      value associated to this attribute.</p>
1198    
1199  <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a    <div class="note memo">
1200  <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>    <p>The attribute can be set to <code>false</code> even if the
1201  exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.      <a href="#Entity"><code>Entity</code></a> node has any child node.
1202  Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value    If the attribute is set to <code>false</code>, then any child node of
1203  associated to the attribute.  No normalization, or lexical validation is    the <a href="#Entity"><code>Entity</code></a> node ought to be ignored,
1204  performed. <span class=ed>@@ If the new value is <code>null</code>,    say, for the purpose of serialization.</p>
1205  ...</span></p>    </div>
1206    
1207      <p>When an <code>EntityReference</code> node is created by cloning
1208      the replacement subtree of the <a href="#Entity"><code>Entity</code></a>
1209      node, if the attribute is set to <code>false</code>, then any descendant
1210      of the node <em class=rfc2119>MUST</em> be ignored.</p>
1211    
1212      <p>If the <a href="#Entity"><code>Entity</code></a> node is created during
1213      the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document,
1214      the following requirements are applied:  If the entity is an unparsed
1215      entity, then the attribute <em class=rfc2119>MUST</em> be set to
1216      <code>false</code>.  Otherwise, if the entity is an external entity whose
1217      replacement text is not available, or whose replacement text is not converted
1218      to a replacement tree, then the attribute <em class=rfc2119>MUST</em> be set
1219      to <code>false</code>.  Otherwise, the attribute
1220      <em class=rfc2119>MUST</em> be set to <code>true</code>.</p>
1221    
1222      <div class="note memo">
1223      <p>An <a href="#Entity"><code>Entity</code></a> node created by the
1224      <a href="#createGeneralEntity"><code>createGeneralEntity</code></a> method
1225      has its <a href="#hasReplacementTree"><code>hasReplacementTree</code></a>
1226      attribute set to <code>false</code>.</p>
1227      </div></dd>
1228    </dl>
1229  </div>  </div>
1230    
1231  </div>  <div class=section id=section-notation>
1232    <h3>Modifications to the <code id=Notation>Notation</code> Interface</h3>
1233    
1234    <p>The implementation of the <a href="#Notation"><code>Notation</code></a>
1235    interface <em class=rfc2119>MUST</em> be modified as following:</p>
1236    <pre class=idl><code>// Modifications to the Notation interface
1237      attribute DOMString <a href="#publicId">publicId</a>;
1238      attribute DOMString <a href="#systemId">systemId</a>;
1239    
1240      // Addition to the Notation interface
1241      readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
1242    </code></pre>
1243    </div>
1244    
1245    <div class=section id=section-processinginstruction>
1246    <h3>Modifications to the
1247    <code id=ProcessingInstruction>ProcessingInstruction</code> Interface</h3>
1248    
1249    <div class=ed>...</div>
1250    </div>
1251    
1252    </div>
1253    
1254  <div id="references" class="section reference">  <div id="references" class="section reference">
1255  <h2>References</h2>  <h2>References</h2>
Legend:
Removed from v.1.14  
changed lines
  Added in v.1.19
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24