/[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.7 by wakaba, Sun Dec 2 09:47:05 2007 UTC revision 1.11 by wakaba, Mon Dec 3 10:12:16 2007 UTC
# Line 10  Line 10 
10    
11  <div class="header">  <div class="header">
12  <h1>DOM Document Type Definition Module</h1>  <h1>DOM Document Type Definition Module</h1>
13  <h2>Working Draft <time datetime=2007-12-01>1 December 2007</time></h2>  <h2>Working Draft <time datetime=2007-12-03>3 December 2007</time></h2>
14    
15  <dl class="versions-uri">  <dl class="versions-uri">
16  <dt>This Version</dt>  <dt>This Version</dt>
# Line 411  not required to raise the exception <spa Line 411  not required to raise the exception <spa
411  <h3>The <code>DocumentTypeDefinition</code> Interface</h3>  <h3>The <code>DocumentTypeDefinition</code> Interface</h3>
412    
413  <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {  <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {
414        readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>;
415      readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>;
416      readonly attribute NamedNodeMap <a href="#notations">notations</a>;
417    
418      <span class=ed>more members come here...</span>
419  }</code></pre>  }</code></pre>
420    
421  <pre class=ed>  <pre class=ed>
# Line 421  feature, a [CODE(DOMi)@en[[[DocumentType Line 425  feature, a [CODE(DOMi)@en[[[DocumentType
425  must implement the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]  must implement the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]
426  interface.  See [[DOM XML Document Type Definition]>>3] for  interface.  See [[DOM XML Document Type Definition]>>3] for
427  details.  details.
428    </pre>
429    
430    <dl>
431  ** Children  <dt><dfn id=elementTypes class=dom-attr><code>elementTypes</code></dfn> of
432    type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
433  [2] The [DFN@en[[CODE(DOMa)@en[[[elementTypes]]]] attribute]]    <dd><p>A live <code>NamedNodeMap</code> object that contains all the element
434  of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface    type definitions belonging to the <code>DocumentType</code> node.</p>
435  is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that  
436  contains all element types belongs to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
437  node.  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].    <code>NamedNodeMap</code> object that contains all the
438  The attribute is read-only.    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
439      nodes belonging to the <code>DocumentType</code> node.  The
440  What are contained in this collection depends on how    <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be read$B!>(Bonly
441  the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node was created.  If the    if and only if the node is read$B!>(Bonly.  The <code>NamedNodeMap</code>
442  node was created as the result of parsing of an XML document,    object <em class=rfc2119>MUST</em> be live and the same object
443  it [['''MUST''']]  contain all element types whose element type and / or    <em class=rfc2119>MUST</em> be returned for any invocation.</p>
444  attribute definition list declaration are encountered by and provided for the DOM  
445  implementation from the XML processor.  Note that the XML processor might not    <p>If the <code>DocumentType</code> node is created during the process
446  provide a part of or entire such information depending on the configuration.    to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, the following
447  If more than one declarations for an element type or an attribute is available    requirements are applied:  The <code>NamedNodeMap</code> object in the
448  at the time of the definition node construction, then declarations other than    <a href="#elementTypes"><code>elementType</code></a> attribute
449  the first ones [['''MUST''']] be discarded.    <em class=rfc2119>MUST</em> be so transformed that the object contains
450      the <code>ElementTypeDefinition</code> nodes for the element types
451  The attribute [['''MUST''']] return the [CODE(DOMi)@en[[[NamedNodeMap]]]]    whose name is presented as the <code>Name</code> of the element type or
452  object that contains all the [CODE(DOMi)@en[[[ElementTypeDefinition]]]] nodes    attribute definition list declarations processed by the <abbr>XML</abbr>
453  belong to the node.  The returned [CODE(DOMi)@en[[[NamedNodeMap]]]] object    processor.  If there is more than one element type declarations for an
454  [['''MUST''']] be read-only if and only if the node is read-only.    element type, then the declarations other than the first one
455  Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live    <em class=rfc2119>MUST</em> be ignored for the purpose of constructing the
456  and therefore any change of read-only flag on the node is immediately    <code>NamedNodeMap</code> object.</p></dd>
457  reflected by that of the object.  <dt><dfn id=generalEntities class=dom-attr><code>generalEntities</code></dfn>
458    of type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
459  [3] The [DFN@en[[CODE(DOMa)@en[[[generalEntities]]]] attribute]]    <dd><p>A live <code>NamedNodeMap</code> object that contains all the general
460  of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface    entities belonging to the <code>DocumentType</code> node.</p>
461  is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that contains all the    
462  general entities belong to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node.    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
463  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].    same value as the <code>entities</code> attribute (defined in the
464  The attribute is read-only.    <code>DocumentType</code> interface) of the same node.</p>
465    
466      <div class="note memo">
467        <p>This attribute is part of the interface for historical reason.</p>
468      </div></dd>
469    <!--
470  All entities declared in the document type definition  All entities declared in the document type definition
471  contained in or referenced from the document entity  contained in or referenced from the document entity
472  might not be exposed through this collection, depending  might not be exposed through this collection, depending
# Line 477  representing general entities belong to Line 486  representing general entities belong to
486  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
487  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
488  reflected by that of the object.  reflected by that of the object.
489    -->
490  The attribute [['''MUST''']] return the same value as the  <dt><dfn id=notations class=dom-attr><code>notations</code></dfn> of type
491  [CODE(DOMa)@en[[[entites]]]] attribute of the  <code>notations</code>, read$B!>(Bonly</code>
492  [CODE(DOMi)@en[[[DocumentType]]]] interface on the same node.    <dd><p>A live <code>NamedNodeMap</code> object that contains all the
493      notations belonging to the <code>DocumentType</code> node.</p>
494  [4] The [DFN@en[[CODE(DOMa)@en[[[notations]]]] attribute]]    
495  of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
496  is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that contains    same value as the <code>notations</code> attribute (defined in the
497  all the notations belong to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]    <code>DocumentType</code> interface) of the same node.</p>
498  node.  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].  
499  The attribute is read-only.    <div class="note memo">
500        <p>This attribute is part of the interface for historical reason.</p>
501        <p>Implementations are not required to implement the
502        <code>notations</code> attribute twice (for <code>DocumentType</code>
503        and <code>DocumentTypeDefinition</code> interfaces); they share exactly
504        same definition.</p>
505      </div></dd>
506    <!--
507  If the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node is  If the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node is
508  created from an XML document, duplicate notation declarations, if any, in DTD  created from an XML document, duplicate notation declarations, if any, in DTD
509  [['''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 512  representing notations belong to the nod Line 527  representing notations belong to the nod
527  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
528  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
529  reflected by that of the object.  reflected by that of the object.
530    -->
531    
532  A DOM implementation is not required to implement the  <dt class=ed>@@ other members...
533  [CODE(DOMa)@en[[[notations]]]] attribute twice  </dl>
 for the [CODE(DOMi)@en[[[DocumentType]]]] and  
 the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interfaces;  
 the latter is defined to contain the same value as the former.  
534    
535    <div class=ed>
536    <p>A future version of this interface might define the
537    <code>parameterEntities</code> and getter/setter for parameter entities.
538    </div>
539    
 ** 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>  
540  </div>  </div>
541    
542  <div class=section id=section-elementtypedefinition>  <div class=section id=section-elementtypedefinition>
543  <h3>The <code>ElementTypeDefinition</code> Interface</h3>  <h3>The <code>ElementTypeDefinition</code> Interface</h3>
544    
545  <pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> {  <pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> : <a href="#Node">Node</a> {
546        readonly attribute <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
547    
548      <span class=ed>@@ more</span>
549  }</code></pre>  }</code></pre>
550    
551  <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members  <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members
# Line 575  interface is defined in [[manakai//DOM E Line 588  interface is defined in [[manakai//DOM E
588  <div class=section id=section-attributedefinition>  <div class=section id=section-attributedefinition>
589  <h3>The <code>AttributeDefinition</code> Interface</h3>  <h3>The <code>AttributeDefinition</code> Interface</h3>
590    
591  <pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> {  <pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> : <a href="#Node">Node</a> {
592      <span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span>
593      const unsigned short <a href="#NO_TYPE_ATTR">NO_TYPE_ATTR</a> = 0;
594      const unsigned short <a href="#CDATA_ATTR">CDATA_ATTR</a> = 1;
595      const unsigned short <a href="#ID_ATTR">ID_ATTR</a> = 2;
596      const unsigned short <a href="#IDREF_ATTR">IDREF_ATTR</a> = 3;
597      const unsigned short <a href="#IDREFS_ATTR">IDREFS_ATTR</a> = 4;
598      const unsigned short <a href="#ENTITY_ATTR">ENTITY_ATTR</a> = 5;
599      const unsigned short <a href="#ENTITIES_ATTR">ENTITIES_ATTR</a> = 6;
600      const unsigned short <a href="#NMTOKEN_ATTR">NMTOKEN_ATTR</a> = 7;
601      const unsigned short <a href="#NMTOKENS_ATTR">NMTOKENS_ATTR</a> = 8;
602      const unsigned short <a href="#NOTATION_ATTR">NOTATION_ATTR</a> = 9;
603      const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10;
604      const unsigned short <a href="#UNKNOWN_ATTR">UNKNOWN_ATTR</a> = 11;
605        
606      readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;
607    
608      readonly attribute unsigned short <a href="#declaredType">declaredType</a>;
609      readonly attribute unsigned short <a href="#defaultType">defaultType</a>;
610    
611      <span class=ed>...</span>
612  }</code></pre>  }</code></pre>
613    
614  <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members  <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members
# Line 620  object is read-only, then throw an Line 652  object is read-only, then throw an
652  then create a [CODE(DOMi)@en[[[Text]]]] node  then create a [CODE(DOMi)@en[[[Text]]]] node
653  whose [CODE(DOMa)@en[[[data]]]] is the new value  whose [CODE(DOMa)@en[[[data]]]] is the new value
654  and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].  and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].
655    </pre>
656    
657    <dl>
658    <dt><dfn id=ownerElementTypeDefinition class=dom-attr><code>ownerElementTypeDefinition</code></dfn>
659    of type
660    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
661    read$B!>(Bonly</dt>
662      <dd><p>The
663      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> to
664      which the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
665      node belongs.</p>
666    
667      <p>On getting, the attribute <em class=rfc2119>MUST</em> return an
668      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.
669      It <em class=rfc2119>MUST</em> be such a node that whose
670      <a href="#attributeDefinitons"><code>attributeDefinitions</code></a>
671      attribute contains the <code>NamedNodeMap</code> object that contains
672      the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
673      node.  If there is no such an
674      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node,
675      then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p>
676    <dt><dfn id=declaredType class=dom-attr><code>declaredType</code></dfn> of type
677    <code>unsigned short</code></dt>
678      <dd><p>The declared type <span class=ed>@@ ref</span> of the attribute.
679      It is expected that this attribute contains a value from the definition group
680      <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>.</p>
681    
682      <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
683      value associated to this attribute.</p>
684    
685      <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
686      <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
687      exception if the
688      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
689      is read$B!>(Bonly <span class=ed>@@ ref</span>.  Otherwise, it
690      <em class=rfc2119>MUST</em> set the specified value as the value
691      associated to this attribute.</p>
692    
693      <p>If the <code>AttributeDefinition</code> node is created during the process
694      to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, an
695      appropriate value from the
696      <a href="#DeclaredValueType"><code>DeclaredValueType</code></a> constant
697      group <em class=rfc2119>MUST</em> be set to the attribute.</p>
698    
699      <!-- DeclaredValueType -->
700    <p>The definition group
701    <dfn id=DeclaredValueType><code>DeclaredValueType</code></dfn> contains
702    integers indicating the declared type of attributes.  The definition
703    group contains the following constants:</p>
704    
705    <table>
706    <thead>
707    <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
708    </thead>
709    <tbody>
710    <tr>
711    <th scope=row><dfn id=NO_TYPE_ATTR class=dom-const><code>NO_TYPE_ATTR</code>
712    <td><code>0</code><td>No value <span class=ed>[INFOSET]</span>.</tr>
713    <tr>
714    <th scope=row><dfn id=CDATA_ATTR class=dom-const><code>CDATA_ATTR</code>
715    <td><code>1</code><td><code>CDATA</code> <span class=ed>[XML]</span>.</tr>
716    <tr>
717    <th scope=row><dfn id=ID_ATTR class=dom-const><code>ID_ATTR</code>
718    <td><code>2</code><td><code>ID</code> <span class=ed>[XML]</span>.</tr>
719    <tr>
720    <th scope=row><dfn id=IDREF_ATTR class=dom-const><code>IDREF_ATTR</code>
721    <td><code>3</code><td><code>IDREF</code> <span class=ed>[XML]</span>.</tr>
722    <tr>
723    <th scope=row><dfn id=IDREFS_ATTR class=dom-const><code>IDREFS_ATTR</code>
724    <td><code>4</code><td><code>IDREFS</code> <span class=ed>[XML]</span>.</tr>
725    <tr>
726    <th scope=row><dfn id=ENTITY_ATTR class=dom-const><code>ENTITY_ATTR</code>
727    <td><code>5</code><td><code>ENTITY</code> <span class=ed>[XML]</span>.</tr>
728    <tr>
729    <th scope=row><dfn id=ENTITIES_ATTR class=dom-const><code>ENTITIES_ATTR</code>
730    <td><code>6</code><td><code>ENTITIES</code> <span class=ed>[XML]</span>.</tr>
731    <tr>
732    <th scope=row><dfn id=NMTOKEN_ATTR class=dom-const><code>NMTOKEN_ATTR</code>
733    <td><code>7</code><td><code>NMTOKEN</code> <span class=ed>[XML]</span>.</tr>
734    <tr>
735    <th scope=row><dfn id=NMTOKENS_ATTR class=dom-const><code>NMTOKENS_ATTR</code>
736    <td><code>8</code><td><code>NMTOKENS</code> <span class=ed>[XML]</span>.</tr>
737    <tr>
738    <th scope=row><dfn id=NOTATION_ATTR class=dom-const><code>NOTATION_ATTR</code>
739    <td><code>9</code><td><code>NOTATION</code> <span class=ed>[XML]</span>.</tr>
740    <tr>
741    <th scope=row><dfn id=ENUMERATION_ATTR class=dom-const><code>ENUMERATION_ATTR</code>
742    <td><code>10</code><td>Enumeration <span class=ed>[XML]</span>.</tr>
743    <tr>
744    <th scope=row><dfn id=UNKNOWN_ATTR class=dom-const><code>UNKNOWN_ATTR</code>
745    <td><code>11</code><td>Unknown, because no declaration for the attribute
746    has been read but the [all declaration processed] property
747    <span class=ed>[INFOSET]</span> would be false.</tr>
748    </tbody>
749    </table>
750    
751    <p>If no attribute type information is available, or if the source
752    of the information does not distinguish <q>no value</q> and <q>unknown</q>
753    <span class=ed>[INFOSET]</span>, then the value
754    <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>
755    <em class=rfc2119>MUST</em> be used.</p>
756    
757  ** Definition groups  <div class="note memo">
758    <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
759    created by the
760    <a href="#createAttributeDefinition"><code>createAttributeDefinition</code></a>
761    method has its <a href="#declaredType"><code>declaredType</code></a> attribute
762    set to <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</p>
763    </div>
764    
765    <p>If the source of the information does not distinguish <q>no value</q>
766    and/or <q>unknown</q> <span class=ed>[INFOSET]</span> and
767    <code>CDATA</code> <span class=ed>[XML]</span>, then the value
768    <a href="#CDATA_ATTR"><code>CDATA_ATTR</code></a> <em class=rfc2119>MUST</em>
769    be used.</p>
770    
771    <p>In Perl binding <span class=ed>[PERLBINDING]</span>, the
772    <code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the
773    <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>
774    definition group.</p>
775    
776      </dd>
777    <dt><dfn id=defaultType class=dom-attr><code>defaultType</code></dfn> of
778    type <code>unsigned short</code></dt>
779      <dd><p>The type of the default for the attribute.  It is expected that this
780      attribute contains a value from the definition group
781      <a href="#DefaultValueType"><code>DefaultValueType</code></a>.</p>
782    
783      <p>On getting, the attribute <em class=rfc2119>MUST</em> return
784      the value associated to this attribute.</p>
785    
786      <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
787      <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
788      exception if the
789      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
790      is read$B!>(Bonly <span class=ed>@@ ref</span>.  Otherwise, it
791      <em class=rfc2119>MUST</em> set the specified value as the value
792      associated to this attribute.</p>
793    
794      <p>If the <code>AttributeDefinition</code> node is created during the process
795      to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, an
796      appropriate value from the
797      <a href="#DefaultValueType"><code>DefaultValueType</code></a> definition
798      group <em class=rfc2119>MUST</em> be set to the attribute.</p>
799    
800      <!-- DefaultValueType -->
801      <p>The definition group
802      <dfn id=DefaultValueType><code>DefaultValueType</code></dfn>
803      contains integers indicating the type of the default for the attribute.
804      The definition group contains the following constans:</p>
805    
806      <table>
807      <thead>
808      <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
809      </thead>
810      <tbody>
811      <tr>
812      <th scope=row><dfn id=UNKNOWN_DEFAULT class=dom-const><code>UNKNOWN_DEFAULT</code></dfn>
813      <td><code>0</code><td>Unknown.</tr>
814      <tr>
815      <th scope=row><dfn id=FIXED_DEFAULT class=dom-const><code>FIXED_DEFAULT</code></dfn>
816      <td><code>1</code><td>Provided explicitly and fixed
817      <span class=ed>@@ ref</span> to that value.</tr>
818      <tr>
819      <th scope=row><dfn id=REQUIRED_DEFAULT class=dom-const><code>REQUIRED_DEFAULT</code></dfn>
820      <td><code>2</code><td>No default value and the attribute have to be
821      explicitly specified.</tr>
822      <tr>
823      <th scope=row><dfn id=IMPLIED_DEFAULT class=dom-const><code>IMPLIED_DEFAULT</code></dfn>
824      <td><code>3</code><td>Implied <span class=ed>@@ ref</span>.</tr>
825      <tr>
826      <th scope=row><dfn id=EXPLICIT_DEFAULT class=dom-const><code>EXPLICIT_DEFAULT</code></dfn>
827      <td><code>4</code><td>Provided explicitly.</tr>
828      </tbody>
829      </table>
830    
831      <p>If the source of the default type does not distinguish
832      implied and unknown default types, then the value
833      <a href="#IMPLIED_DEFAULT"><code>IMPLIED_DEFAULT</code></a>
834      <em class=rfc2119>MUST</em> be used.</p>
835    
836      <div class="note memo">
837      <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
838      node created by the
839      <a href="#createAttributeDefinition"><code>createAttributeDefinition</code></a>
840      method has its <a href="#defaultType"><code>defaultType</code></a>
841      attribute set to
842      <a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</p>
843      </div></dd>
844    </dl>
845    
 [6] The  
 [DFN@en[definition group [CODE(DOM)@en[[[DeclaredValueType]]]]]]  
 contains integers indicating the type of  
 attribute value:  
 ,[CODE(DOMc)@en[[[NO_TYPE_ATTR]]]],[CODE(IDL)[[[0]]]],The attribute value type corresponding to [[no value]] in XML Information Set.  
 ,[CODE(DOMc)@en[[[CDATA_ATTR]]]],[CODE(IDL)[[[1]]]],The attribute value type is [CODE(XML)@en[[[CDATA]]]].  
 ,[CODE(DOMc)@en[[[ID_ATTR]]]],[CODE(IDL)[[[2]]]],The attribute value type is [CODE(XML)@en[[[ID]]]].  
 ,[CODE(DOMc)@en[[[IDREF_ATTR]]]],[CODE(IDL)[[[3]]]],The attribute value type is [CODE(XML)@en[[[IDREF]]]].  
 ,[CODE(DOMc)@en[[[IDREFS_ATTR]]]],[CODE(IDL)[[[4]]]],The attribute value type is [CODE(XML)@en[[[IDREFS]]]].  
 ,[CODE(DOMc)@en[[[ENTITY_ATTR]]]],[CODE(IDL)[[[5]]]],The attribute value type is [CODE(XML)@en[[[ENTITY]]]].  
 ,[CODE(DOMc)@en[[[ENTITIES_ATTR]]]],[CODE(IDL)[[[6]]]],The attribute value type is [CODE(XML)@en[[[ENTITIES]]]].  
 ,[CODE(DOMc)@en[[[NMTOKEN_ATTR]]]],[CODE(IDL)[[[7]]]],The attribute value type is [CODE(XML)@en[[[NMTOKEN]]]].  
 ,[CODE(DOMc)@en[[[NMTOKENS_ATTR]]]],[CODE(IDL)[[[8]]]],The attribute value type is [CODE(XML)@en[[[NMTOKENS]]]].  
 ,[CODE(DOMc)@en[[[NOTATION_ATTR]]]],[CODE(IDL)[[[9]]]],The attribute value type is [CODE(XML)@en[[[NOTATION]]]].  
 ,[CODE(DOMc)@en[[[ENUMERATION_ATTR]]]],[CODE(IDL)[[[10]]]],The attribute value is enumeration type.  
 ,[CODE(DOMc)@en[[[UNKNOWN_ATTR]]]],[CODE(IDL)[[[11]]]],"The attribute value type is unknown, because no declaration for the attribute has been read but not [CODE(InfoProp)@en[[[all declarations processed]]]] property would be false."  
   
 The type of these constants are  
 [CODE(IDL)@en[[[unsigned]] [[short]]]].  
   
 If no attribute type information is provided,  
 or if the source of that information does not  
 distinguish [[no value]] and [[unknown]] as in  
 XML Information Set, then the  
 [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]] value  
 [['''MUST''']] be used.  
   
 ;; A newly created [CODE(DOMi)@en[[[AttributeDefinition]]]]  
 object by [CODE(DOMm)@en[[[createAttributeDefinition]]]]  
 method has [CODE(DOMa)@en[[[declaredType]]]] attribute  
 set to [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].  
   
 If the source of the attribute type information  
 does not distinguish [[no value]] and / or [[unknown]]  
 and [CODE(XML)@en[[[CDATA]]]], then the  
 [CODE(DOMc)@en[[[CDATA_ATTR]]]] value [['''MUST''']]  
 be used.  
   
 [11]  
 In Perl binding, the objects implementing the  
 [CODE(DOMi)@en[[[Attr]]]] interface [['''MUST''']]  
 also implement the [CODE(DOM)@en[[[DeclaredValueType]]]]  
 constant group.  
   
 [7] The  
 [DFN@en[definition group [CODE(DOM)@en[[[DefaultValueType]]]]]]  
 contains integers indicating the type of  
 default attribute value:  
 ,[CODE(DOMc)@en[[[UNKNOWN_DEFAULT]]]],[CODE(IDL)[[[0]]]],The default value is unknown.  
 ,[CODE(DOMc)@en[[[FIXED_DEFAULT]]]],[CODE(IDL)[[[1]]]],The default value is provided and the attribute is [CODE(XML)@en[#[[FIXED]]]] to that value.  
 ,[CODE(DOMc)@en[[[REQUIRED_DEFAULT]]]],[CODE(IDL)[[[2]]]],An attribute specification is [CODE(XML)@en[#[[REQUIRED]]]] for the attribute.  
 ,[CODE(DOMc)@en[[[IMPLIED_DEFAULT]]]],[CODE(IDL)[[[3]]]],The default value is [CODE(XML)@en[#[[IMPLIED]]]].  
 ,[CODE(DOMc)@en[[[EXPLICIT_DEFAULT]]]],[CODE(IDL)[[[4]]]],The default value is provided but the attribute is not fixed to it.  
   
 The type of these constants are  
 [CODE(IDL)@en[[[unsigned]] [[short]]]].  
   
 If the source of the attribute default value type  
 does not distinguish the [CODE(XML)@en[#[[IMPLIED]]]]  
 default and unknown default, then the  
 [CODE(DOMc)@en[[[IMPLIED_DEFAULT]]]] value  
 [['''MUST''']] be used.  
   
 ;; A newly created [CODE(DOMi)@en[[[AttributeDefinition]]]]  
 object by [CODE(DOMm)@en[[[createAttributeDefinition]]]]  
 method has [CODE(DOMa)@en[[[declaredType]]]] attribute  
 set to [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].  
   
 ** Tree-relationship Attributes  
   
 [10]  
 The  
 [DFN@en[[CODE(DOMa)@en[[[ownerElementTypeDefinition]]]] attribute]]  
 of the [CODE(DOMi)@en[[[AttributeDefinition]]]] interface  
 is read-only and of type  
 [CODE(DOMi)@en[[[ElementTypeDefinition]]]].  
 It is the [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node  
 which the [CODE(DOMi)@en[[[AttributeDefinition]]]] node  
 belong to.  
   
 If the [CODE(DOMi)@en[[[AttributeDefinition]]]] node  
 is included in the [CODE(DOMa)@en[[[attributeDefinitions]]]]  
 list of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node,  
 then the attribute [['''MUST''']] return the  
 [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node.  
 Otherwise, it [['''MUST''']] return [CODE(DOM)@en[[[null]]]].  
   
 ;; This attribute is analogue to the  
 [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute  
 for [CODE(DOMi)@en[[[ElementTypeDefinition]]]],  
 [CODE(DOMi)@en[[[Entity]]]], and [CODE(DOMi)@en[[[Notation]]]]  
 nodes, or the [CODE(DOMa)@en[[[ownerElement]]]]  
 attribute for [CODE(DOMi)@en[[[Attr]]]] nodes.  
   
 ** Attributes  
   
 [5]  
 The [DFN@en[[CODE(DOMa)@en[[[declaredType]]]] attribute]]  
 of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  
 represents the type of the attribute value.  
   
 This attribute is read-write.  
 The type of the attribute is  
 [CODE(IDL)@en[[[unsigned]] [[short]]]].  It is expected  
 that this attribute has a value from the definition group  
 [CODE(DOM)@en[[[DeclaredValueType]]]].  
   
 The getter [['''MUST''']] return a value associated  
 to this attribute.  
   
 The setter [['''MUST''']]  
 throw a [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]]  
 [CODE(DOMi)@en[[[DOMException]]]] if the  
 [CODE(DOMi)@en[[[AttributeDefinition]]]] object is read-only.  
 Otherwise, the setter [['''MUST''']] set the specified  
 value as the value associated to this attribute.  
   
 If a parser create an [CODE(DOMi)@en[[[AttributeDefinition]]]]  
 object, then it [['''MUST''']] set a value  
 from the [CODE(DOM)@en[[[DeclaredValueType]]]]  
 definition group.  
   
 [8]  
 The [DFN@en[[CODE(DOMa)@en[[[defaultType]]]] attribute]]  
 of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  
 represents the type of the attribute default value.  
   
 This attribute is read-write.  
 The type of the attribute is  
 [CODE(IDL)@en[[[unsigned]] [[short]]]].  It is expected  
 that this attribute has a value from the definition group  
 [CODE(DOM)@en[[[DefaultValueType]]]].  
   
 The getter [['''MUST''']] return a value associated  
 to this attribute.  
   
 The setter [['''MUST''']]  
 throw a [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]]  
 [CODE(DOMi)@en[[[DOMException]]]] if the  
 [CODE(DOMi)@en[[[AttributeDefinition]]]] object is read-only.  
 Otherwise, the setter [['''MUST''']] set the specified  
 value as the value associated to this attribute.  
   
 If a parser create an [CODE(DOMi)@en[[[AttributeDefinition]]]]  
 object, then it [['''MUST''']] set a value  
 from the [CODE(DOM)@en[[[DefaultValueType]]]]  
 definition group.</pre>  
846  </div>  </div>
847    
848  </div>  </div>
Legend:
Removed from v.1.7  
changed lines
  Added in v.1.11
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24