/[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.9 by wakaba, Sun Dec 2 10:44:42 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 542  reflected by that of the object. Line 542  reflected by that of the object.
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 586  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>    <span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span>
593    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;
594    const unsigned short <a href="#CDATA_ATTR">CDATA_ATTR</a> = 1;    const unsigned short <a href="#CDATA_ATTR">CDATA_ATTR</a> = 1;
# Line 601  interface is defined in [[manakai//DOM E Line 603  interface is defined in [[manakai//DOM E
603    const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10;    const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10;
604    const unsigned short <a href="#UNKNOWN_ATTR">UNKNOWN_ATTR</a> = 11;    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>    <span class=ed>...</span>
612  }</code></pre>  }</code></pre>
613    
# Line 647  whose [CODE(DOMa)@en[[[data]]]] is the n Line 654  whose [CODE(DOMa)@en[[[data]]]] is the n
654  and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].  and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].
655  </pre>  </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  <p>The definition group
701  <dfn id=DeclaredValueType><code>DeclaredValueType</code></dfn> contains  <dfn id=DeclaredValueType><code>DeclaredValueType</code></dfn> contains
702  integers indicating the declared type of attributes.</p>  integers indicating the declared type of attributes.  The definition
703    group contains the following constants:</p>
704    
705  <table>  <table>
706  <thead>  <thead>
# Line 712  set to <a href="#NO_TYPE_ATTR"><code>NO_ Line 763  set to <a href="#NO_TYPE_ATTR"><code>NO_
763  </div>  </div>
764    
765  <p>If the source of the information does not distinguish <q>no value</q>  <p>If the source of the information does not distinguish <q>no value</q>
766  and/or <code>unknown</code> <span class=ed>[INFOSET]</span> and  and/or <q>unknown</q> <span class=ed>[INFOSET]</span> and
767  <code>CDATA</code> <span class=ed>[XML]</span>, then the value  <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>  <a href="#CDATA_ATTR"><code>CDATA_ATTR</code></a> <em class=rfc2119>MUST</em>
769  be used.</p>  be used.</p>
# Line 720  be used.</p> Line 771  be used.</p>
771  <p>In Perl binding <span class=ed>[PERLBINDING]</span>, the  <p>In Perl binding <span class=ed>[PERLBINDING]</span>, the
772  <code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the  <code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the
773  <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>  <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>
774  constant group.</p>  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    
 <pre class=ed>  
 [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.9  
changed lines
  Added in v.1.11

admin@suikawiki.org
ViewVC Help
Powered by ViewVC 1.1.24