/[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.18 by wakaba, Tue Dec 4 11:08:48 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-04>4 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 177  aforementioned cases.</p> Line 183  aforementioned cases.</p>
183  <div class=section id=section-node>  <div class=section id=section-node>
184  <h3>Modifications to the <code id=Node>Node</code> Interface</h3>  <h3>Modifications to the <code id=Node>Node</code> Interface</h3>
185    
186    <p>The implementation of the
187    <a href="#Node"><code>Node</code></a> interface
188    <em class=rfc2119>MUST</em> be modified as following:</p>
189  <pre class=idl><code>// Additions to the Node interface  <pre class=idl><code>// Additions to the Node interface
190    
191  // Additions to the NodeType definition group  // Additions to the NodeType definition group
# Line 197  these kinds of nodes, methods and attrib Line 206  these kinds of nodes, methods and attrib
206  <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>
207    
208  <dl>  <dl>
209    <dt><code id=attributes>attributes</code></dt>
210      <dd>
211        <p>On getting, the attribute <em class=rfc2119>MUST</em> return
212        <code>null</code>.</p>
213      </dd>
214    <dt><code id=baseURI>baseURI</code></dt>
215      <dd>
216        <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
217        value of the <a href="#baseURI"><code>baseURI</code></a> attribute
218        of the node in the <code>ownerDocument</code> attribute of the node.
219        Note that the value might be <code>null</code>.</p>
220      </dd>
221    <dt><code id=nodeName>nodeName</code></dt>
222      <dd>
223        <p>If the node is an
224        <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
225        On getting, the attribute <em class=rfc2119>MUST</em> return the
226        name of the element type definition represented by the node.</p>
227    
228        <p>If the node is an
229        <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:
230        On getting, the attribute <em class=rfc2119>MUST</em> return the
231        name of the attribute definition represented by the node.</p>
232      </dd>
233  <dt><code id=nodeType>nodeType</code></dt>  <dt><code id=nodeType>nodeType</code></dt>
234    <dd>    <dd>
235      <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 260  following:</p>
260  </tbody>  </tbody>
261  </table>  </table>
262    </dd>    </dd>
263    <dt><code id=nodeValue>nodeValue</code> and
264    <code id=textContent>textContent</code></dt>
265      <dd>
266        <p>If the node is an
267        <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
268        On getting, the attributes <em class=rfc2119>MUST</em> return the
269        name of the element type.</p>
270    
271        <div class="note memo">
272          <p>Thus, on setting the attributes does nothing
273          <span class=ed>[DOM3]</span>.</p>
274        </div>
275    
276        <p>On setting, the <a href="#textContent"><code>textContent</code></a>
277        attribute <em class=rfc2119>MUST NOT</em> raise a
278        <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>.
279        <span class=ed>@@ I forgot why this requirement is necessary.</span></p>
280    
281        <p>If the node is an
282        <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:</p>
283    
284        <pre class=ed>
285    The getter of the [CODE(DOMa)@en[[[nodeValue]]]] attribute
286    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
287    [['''MUST''']] return the normalized default value
288    of the attribute.
289    
290    @@
291    
292    [4] The getter of the [CODE(DOMa)@en[[[textContent]]]]
293    attribute of an [CODE(DOMi)@en[[[AttributeDefinition]]]]
294    object [['''MUST''']] behave as if it were an
295    [CODE(DOMi)@en[[[Attr]]]] object.
296    
297    The setter of the [CODE(DOMa)@en[[[textContent]]]] attribute
298    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
299    [['''MUST''']] behave as if the following algorithm
300    is performed:
301    = If the [CODE(DOMi)@en[[[AttributeDefinition]]]]
302    object is read-only, then throw an
303    [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].
304    = Remove any child node the node has.
305    = If the new value is not empty and not [CODE(IDL)@en[[[null]]]],
306    then create a [CODE(DOMi)@en[[[Text]]]] node
307    whose [CODE(DOMa)@en[[[data]]]] is the new value
308    and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].
309    </pre>
310      </dd>
311  <dt class=ed>@@ ...</dt>  <dt class=ed>@@ ...</dt>
312  </dl>  </dl>
313    
# Line 235  following:</p> Line 316  following:</p>
316  <div class=section id=section-documentxdoctype>  <div class=section id=section-documentxdoctype>
317  <h3>The <code>DocumentXDoctype</code> Interface</h3>  <h3>The <code>DocumentXDoctype</code> Interface</h3>
318    
319    <p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface
320    <em class=rfc2119>MUST</em> be implemented as following:</p>
321  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {
322    DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>    DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>
323      (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)      (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)
# Line 463  define it for <code>Document</code> meth Line 546  define it for <code>Document</code> meth
546    
547  </div>  </div>
548    
549    
550    <div class=section id=section-documenttype>
551    <h3>Modifications to the <code id=DocumentType>DocumentType</code>
552    Interface</h3>
553    
554    <p>A <a href="#DocumentType"><code>DocumentType</code></a> interface
555    <em class=rfc2119>MAY</em> contain zero or more
556    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
557    nodes in the <code>NodeList</code> object contained in the
558    <code>childNodes</code> attribute of the
559    <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
560    
561    <p>If the <a href="#DocumentType"><code>DocumentType</code></a> node is created
562    during the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr>
563    document, the <code>NodeList</code> object in the <code>childNodes</code>
564    object <em class=rfc2119>MUST</em> contains the
565    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
566    nodes representing the processing instructions in the document type
567    definition of the document processed <span class=ed>@@ ref</span> by
568    the <abbr>XML</abbr> processor.  If the
569    <a href="#DocumentType"><code>DocumentType</code></a> node is marked
570    as read$B!>(Bonly, then all the child nodes <em class=rfc2119>MUST</em>
571    also be marked as read$B!>(Bonly.</p>
572    
573    <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is created
574    from a document type declaration information item <span class=ed>@@ ref</span>,
575    the <code>NodeList</code> object in the <code>childNodes</code> attribute
576    of the node <em class=rfc2119>MUST</em> contain the
577    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes
578    created from the processing instruction information items in the list in the
579    [children] property of the document type declaration item in the same
580    order.</p>
581    
582    <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is mapped to
583    a document type declaration information item, the list in the [children]
584    property <em class=rfc2119>MUST</em> contain the processng instruction
585    information items created from the
586    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes
587    in the <code>NodeList</code> object in the <code>childNodes</code> attribute
588    of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
589    
590    <p>The implementation of the
591    <a href="#DocumentType"><code>DocumentType</code></a> interface
592    <em class=rfc2119>MUST</em> be modified as following:</p>
593    <pre class=idl><code>// Modifications to the DocumentType interface
594      attribute DOMString <a href="#publicId">publicId</a>;
595      attribute DOMString <a href="#systemId">systemId</a>;
596    
597      attribute DOMString <a href="#internalSubset">internalSubset</a>;
598    </code></pre>
599    
600    <p>The <code id=publicId>publicId</code> attribute and the
601    <code id=systemId>systemId</code> attribute of
602    <a href="#DocumentType"><code>DocumentType</code></a>,
603    <a href="#Entity"><code>Entity</code></a>, and
604    <a href="#Notation"><code>Notation</code></a> interfaces are no longer
605    read$B!>(Bonly.</p>
606    
607    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
608    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
609    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.  
610    Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value
611    associated to the attribute.  No normalization, relative reference resolution,
612    or lexical validation is performed. <span class=ed>@@ If the new
613    value is <code>null</code>, ...</span></p>
614    
615    <div class="note memo">
616    <p>Setting an invalid identifier might make the node unserializable.
617    Setting a public identifier while leaveing system identifier unspecified
618    would also make the <a href="#DocumentType"><code>DocumentType</code></a>
619    or <a href="#Entity"><code>Entity</code></a> node unserializable.</p>
620    </div>
621    
622    <div class=ed>
623    <p>ISSUE: In HTML5, Firefox 1.5, and Opera 9, not specifying public or system identifier results in empty strings.</p>
624    </div>
625    
626    <p>The <code id=internalSubset>internalSubset</code> attribute of the
627    <a href="#DocumentType"><code>DocumentType</code></a> interface is no longer
628    read$B!>(Bonly.</p>
629    
630    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
631    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
632    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.  
633    Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value
634    associated to the attribute.  No normalization, or lexical validation is
635    performed. <span class=ed>@@ If the new value is <code>null</code>,
636    ...</span></p>
637    
638    </div>
639    
640  <div class=section id=section-documenttypedefinition>  <div class=section id=section-documenttypedefinition>
641  <h3>The <code>DocumentTypeDefinition</code> Interface</h3>  <h3>The <code>DocumentTypeDefinition</code> Interface</h3>
642    
643    <div class="note memo">
644    <p>This interface is a separated interface from the
645    <a href="#DocumentType"><code>DocumentType</code></a>, not a set of extensions
646    to the <a href="#DocumentType"><code>DocumentType</code></a>,
647    for the historical reason.</p>
648    </div>
649    
650    <p>The
651    <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
652    interface <em class=rfc2119>MUST</em> be implemented as following:</p>
653  <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {  <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {
654    readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>;    readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>;
655    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 797  reflected by that of the object.
797  <div class=section id=section-elementtypedefinition>  <div class=section id=section-elementtypedefinition>
798  <h3>The <code>ElementTypeDefinition</code> Interface</h3>  <h3>The <code>ElementTypeDefinition</code> Interface</h3>
799    
800    <p>The nodes of type
801    <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>
802    represents an element type definition.  Such a node implements the
803    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
804    interface, which extends the <a href="#Node"><code>Node</code></a>
805    interface.</p>
806    
807    <p>An element type definition represents a definition of the element type.
808    It is corresponding to the element type declaration in <abbr>DTD</abbr>.
809    However, an
810    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
811    does not represent the element type definition in <abbr>DTD</abbr> itself.  
812    Even if there are more than one element type declarations for an element type
813    in <abbr>DTD</abbr>, the result <abbr>DOM</abbr> will contain only an
814    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
815    node for that element type.  In addition, if there are attribute definition
816    declarations for an element type, even when there is no element type
817    declaration for that element type, the <abbr>DOM</abbr> will contain an
818    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
819    node for that element type.</p>
820    
821    <p>The <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
822    interface <em class=rfc2119>MUST</em> be implemented as following:</p>
823  <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> {
824    readonly attribute <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;    readonly attribute <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
825    
826    <span class=ed>@@ more</span>    <span class=ed>@@ more</span>
827  }</code></pre>  }</code></pre>
828    
829  <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members  <pre class=ed>
   
 [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute  
 of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object  
 [['''MUST''']] return [CODE(IDL)@en[[[null]]]].  
   
 [4] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute  
 of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object  
 [['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]  
 of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the  
 [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object.  
 Note that it might be [CODE(IDL)@en[[[null]]]].  
   
 [1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute  
 of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object  
 [['''MUST''']] return the name of the element type.  
   
 [2] The getters of the [CODE(DOMa)@en[[[nodeValue]]]]  
 and [CODE(DOMa)@en[[[textContent]]]] attributes  
 of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]  
 object [['''MUST''']] return [CODE(IDL)@en[[[null]]]].  
   
 ;; Thus, the setter of these attributes do nothing.  
   
 The setter of the [CODE(DOMa)@en[[[textContent]]]]  
 attribute of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]  
 object [['''MUST NOT''']] throw a  
 [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].  
   
 ** The [CODE(DOMi)@en[ElementTypeDefinition]] Interface  
   
 [5] The  
830  [DFN@en[[CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute]]  [DFN@en[[CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute]]
831  of the [CODE(DOMi)@en[[[ElementTypeDefinition]]]]  of the [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
832  interface is defined in [[manakai//DOM Extensions]>>50].</pre>  interface is defined in [[manakai//DOM Extensions]>>50].</pre>
# Line 659  interface is defined in [[manakai//DOM E Line 835  interface is defined in [[manakai//DOM E
835  <div class=section id=section-attributedefinition>  <div class=section id=section-attributedefinition>
836  <h3>The <code>AttributeDefinition</code> Interface</h3>  <h3>The <code>AttributeDefinition</code> Interface</h3>
837    
838    <p>The nodes of type
839    <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>
840    represents an attribute definition.  Such a node implements the
841    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> interface,
842    which extends the <a href="#Node"><code>Node</code></a> interface.</p>
843    
844    <p>An attribute definition represents a definition of the attribute
845    associated to an element type.  It is corresponding to the attribute definition
846    in the attribute list declaration in <abbr>DTD</abbr>.  However, an
847    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node does
848    not represent the attribute definition in <abbr>DTD</abbr> itself.  Even if
849    there are more than one attribute definitions for an attribute of an element
850    type in <abbr>DTD</abbr>, the result <abbr>DOM</abbr> will contain only an
851    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node for
852    that attribute.</p>
853    
854    <p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
855    interface <em class=rfc2119>MUST</em> be implemented as following:</p>
856  <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> {
857    <span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span>    <span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span>
858    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 867  interface is defined in [[manakai//DOM E
867    const unsigned short <a href="#NOTATION_ATTR">NOTATION_ATTR</a> = 9;    const unsigned short <a href="#NOTATION_ATTR">NOTATION_ATTR</a> = 9;
868    const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10;    const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10;
869    const unsigned short <a href="#UNKNOWN_ATTR">UNKNOWN_ATTR</a> = 11;    const unsigned short <a href="#UNKNOWN_ATTR">UNKNOWN_ATTR</a> = 11;
870    
871      <span class=comment>// <a href="#DefaultValueType">DefaultValueType</a></span>
872      const unsigned short <a href="#UNKNOWN_DEFAULT">UNKNOWN_DEFAULT</a> = 0;
873      const unsigned short <a href="#FIXED_DEFAULT">FIXED_DEFAULT</a> = 1;
874      const unsigned short <a href="#REQUIRED_DEFAULT">REQUIRED_DEFAULT</a> = 2;
875      const unsigned short <a href="#IMPLIED_DEFAULT">IMPLIED_DEFAULT</a> = 3;
876      const unsigned short <a href="#EXPLICIT_DEFAULT">EXPLICIT_DEFAULT</a> = 4;
877        
878    readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;    readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;
879    
# Line 682  interface is defined in [[manakai//DOM E Line 883  interface is defined in [[manakai//DOM E
883    <span class=ed>...</span>    <span class=ed>...</span>
884  }</code></pre>  }</code></pre>
885    
 <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>  
   
886  <dl>  <dl>
887  <dt><dfn id=ownerElementTypeDefinition class=dom-attr><code>ownerElementTypeDefinition</code></dfn>  <dt><dfn id=ownerElementTypeDefinition class=dom-attr><code>ownerElementTypeDefinition</code></dfn>
888  of type  of type
# Line 917  type <code>unsigned short</code></dt> Line 1075  type <code>unsigned short</code></dt>
1075    
1076  </div>  </div>
1077    
 <div class=section id=section-documenttype>  
 <h3>Modifications to the <code id=DocumentType>DocumentType</code>  
 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>  
   
 <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is created  
 from a document type declaration information item <span class=ed>@@ ref</span>,  
 the <code>NodeList</code> object in the <code>childNodes</code> attribute  
 of the node <em class=rfc2119>MUST</em> contain the  
 <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes  
 created from the processing instruction information items in the list in the  
 [children] property of the document type declaration item in the same  
 order.</p>  
   
 <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  
   attribute DOMString <a href="#publicId">publicId</a>;  
   attribute DOMString <a href="#systemId">systemId</a>;  
   
   attribute DOMString <a href="#internalSubset">internalSubset</a>;  
 </code></pre>  
   
 <p>The <code id=publicId>publicId</code> attribute and the  
 <code id=systemId>systemId</code> attribute of  
 <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  
 read$B!>(Bonly.</p>  
   
 <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a  
 <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>  
 exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.    
 Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value  
 associated to the attribute.  No normalization, relative reference resolution,  
 or lexical validation is performed. <span class=ed>@@ If the new  
 value is <code>null</code>, ...</span></p>  
   
 <div class="note memo">  
 <p>Setting an invalid identifier might make the node unserializable.  
 Setting a public identifier while leaveing system identifier unspecified  
 would also make the <a href="#DocumentType"><code>DocumentType</code></a>  
 or <a href="#Entity"><code>Entity</code></a> node unserializable.</p>  
 </div>  
   
 <div class=ed>  
 <p>ISSUE: In HTML5, Firefox 1.5, and Opera 9, not specifying public or system identifier results in empty strings.</p>  
 </div>  
   
 <p>The <code id=internalSubset>internalSubset</code> attribute of the  
 <a href="#DocumentType"><code>DocumentType</code></a> interface is no longer  
 read$B!>(Bonly.</p>  
   
 <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a  
 <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>  
 exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.    
 Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value  
 associated to the attribute.  No normalization, or lexical validation is  
 performed. <span class=ed>@@ If the new value is <code>null</code>,  
 ...</span></p>  
   
 </div>  
   
1078  </div>  </div>
1079    
1080    
Legend:
Removed from v.1.14  
changed lines
  Added in v.1.18
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24