/[suikacvs]/markup/xml/domdtdef/domdtdef-work.en.html

Diff of /markup/xml/domdtdef/domdtdef-work.en.html

Parent Directory | Revision Log | View Patch Patch

-revision 1.7 by wakaba,
Sun Dec  2 09:47:05 2007 UTC
+revision 1.9 by wakaba,
Sun Dec  2 10:44:42 2007 UTC
 Line 411 
 not required to raise the exception <spa
  <h3>The <code>DocumentTypeDefinition</code> Interface</h3>
  <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {
+   readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>;
+   readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>;
+   readonly attribute NamedNodeMap <a href="#notations">notations</a>;
+   <span class=ed>more members come here...</span>
  }</code></pre>
  <pre class=ed>
-Line 421 
 feature, a [CODE(DOMi)@en[[[DocumentType
+Line 425 
 feature, a [CODE(DOMi)@en[[[DocumentType
  must implement the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]
  interface.  See [[DOM XML Document Type Definition]>>3] for
  details.
+ </pre>
+ <dl>
- ** Children
+ <dt><dfn id=elementTypes class=dom-attr><code>elementTypes</code></dfn> of
+ type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
- [2] The [DFN@en[[CODE(DOMa)@en[[[elementTypes]]]] attribute]]
+   <dd><p>A live <code>NamedNodeMap</code> object that contains all the element
- of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface
+   type definitions belonging to the <code>DocumentType</code> node.</p>
- is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that
- contains all element types belongs to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
- node.  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].
+   <code>NamedNodeMap</code> object that contains all the
- The attribute is read-only.
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
+   nodes belonging to the <code>DocumentType</code> node.  The
- What are contained in this collection depends on how
+   <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be read$B!>(Bonly
- the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node was created.  If the
+   if and only if the node is read$B!>(Bonly.  The <code>NamedNodeMap</code>
- node was created as the result of parsing of an XML document,
+   object <em class=rfc2119>MUST</em> be live and the same object
- it [['''MUST''']]  contain all element types whose element type and / or
+   <em class=rfc2119>MUST</em> be returned for any invocation.</p>
- attribute definition list declaration are encountered by and provided for the DOM
- implementation from the XML processor.  Note that the XML processor might not
+   <p>If the <code>DocumentType</code> node is created during the process
- 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
- If more than one declarations for an element type or an attribute is available
+   requirements are applied:  The <code>NamedNodeMap</code> object in the
- at the time of the definition node construction, then declarations other than
+   <a href="#elementTypes"><code>elementType</code></a> attribute
- the first ones [['''MUST''']] be discarded.
+   <em class=rfc2119>MUST</em> be so transformed that the object contains
+   the <code>ElementTypeDefinition</code> nodes for the element types
- The attribute [['''MUST''']] return the [CODE(DOMi)@en[[[NamedNodeMap]]]]
+   whose name is presented as the <code>Name</code> of the element type or
- object that contains all the [CODE(DOMi)@en[[[ElementTypeDefinition]]]] nodes
+   attribute definition list declarations processed by the <abbr>XML</abbr>
- belong to the node.  The returned [CODE(DOMi)@en[[[NamedNodeMap]]]] object
+   processor.  If there is more than one element type declarations for an
- [['''MUST''']] be read-only if and only if the node is read-only.
+   element type, then the declarations other than the first one
- Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live
+   <em class=rfc2119>MUST</em> be ignored for the purpose of constructing the
- and therefore any change of read-only flag on the node is immediately
+   <code>NamedNodeMap</code> object.</p></dd>
- reflected by that of the object.
+ <dt><dfn id=generalEntities class=dom-attr><code>generalEntities</code></dfn>
+ of type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
- [3] The [DFN@en[[CODE(DOMa)@en[[[generalEntities]]]] attribute]]
+   <dd><p>A live <code>NamedNodeMap</code> object that contains all the general
- of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface
+   entities belonging to the <code>DocumentType</code> node.</p>
- is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that contains all the
- general entities belong to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node.
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
- The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].
+   same value as the <code>entities</code> attribute (defined in the
- The attribute is read-only.
+   <code>DocumentType</code> interface) of the same node.</p>
+   <div class="note memo">
+     <p>This attribute is part of the interface for historical reason.</p>
+   </div></dd>
+ <!--
  All entities declared in the document type definition
  contained in or referenced from the document entity
  might not be exposed through this collection, depending
-Line 477 
 representing general entities belong to
+Line 486 
 representing general entities belong to
  the node is read-only. Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live
  and therefore any change of read-only flag on the node is immediately
  reflected by that of the object.
+ -->
- The attribute [['''MUST''']] return the same value as the
+ <dt><dfn id=notations class=dom-attr><code>notations</code></dfn> of type
- [CODE(DOMa)@en[[[entites]]]] attribute of the
+ <code>notations</code>, read$B!>(Bonly</code>
- [CODE(DOMi)@en[[[DocumentType]]]] interface on the same node.
+   <dd><p>A live <code>NamedNodeMap</code> object that contains all the
+   notations belonging to the <code>DocumentType</code> node.</p>
- [4] The [DFN@en[[CODE(DOMa)@en[[[notations]]]] attribute]]
- of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
- is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that contains
+   same value as the <code>notations</code> attribute (defined in the
- all the notations belong to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]
+   <code>DocumentType</code> interface) of the same node.</p>
- node.  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].
- The attribute is read-only.
+   <div class="note memo">
+     <p>This attribute is part of the interface for historical reason.</p>
+     <p>Implementations are not required to implement the
+     <code>notations</code> attribute twice (for <code>DocumentType</code>
+     and <code>DocumentTypeDefinition</code> interfaces); they share exactly
+     same definition.</p>
+   </div></dd>
+ <!--
  If the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node is
  created from an XML document, duplicate notation declarations, if any, in DTD
  [['''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
  the node is read-only. Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live
  and therefore any change of read-only flag on the node is immediately
  reflected by that of the object.
+ -->
- A DOM implementation is not required to implement the
+ <dt class=ed>@@ other members...
- [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.
+ <div class=ed>
+ <p>A future version of this interface might define the
+ <code>parameterEntities</code> and getter/setter for parameter entities.
+ </div>
- ** 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>
  </div>
  <div class=section id=section-elementtypedefinition>
-Line 576 
 interface is defined in [[manakai//DOM E
+Line 587 
 interface is defined in [[manakai//DOM E
  <h3>The <code>AttributeDefinition</code> Interface</h3>
  <pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> {
+   <span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span>
+   const unsigned short <a href="#NO_TYPE_ATTR">NO_TYPE_ATTR</a> = 0;
+   const unsigned short <a href="#CDATA_ATTR">CDATA_ATTR</a> = 1;
+   const unsigned short <a href="#ID_ATTR">ID_ATTR</a> = 2;
+   const unsigned short <a href="#IDREF_ATTR">IDREF_ATTR</a> = 3;
+   const unsigned short <a href="#IDREFS_ATTR">IDREFS_ATTR</a> = 4;
+   const unsigned short <a href="#ENTITY_ATTR">ENTITY_ATTR</a> = 5;
+   const unsigned short <a href="#ENTITIES_ATTR">ENTITIES_ATTR</a> = 6;
+   const unsigned short <a href="#NMTOKEN_ATTR">NMTOKEN_ATTR</a> = 7;
+   const unsigned short <a href="#NMTOKENS_ATTR">NMTOKENS_ATTR</a> = 8;
+   const unsigned short <a href="#NOTATION_ATTR">NOTATION_ATTR</a> = 9;
+   const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10;
+   const unsigned short <a href="#UNKNOWN_ATTR">UNKNOWN_ATTR</a> = 11;
+   <span class=ed>...</span>
  }</code></pre>
  <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members
-Line 620 
 object is read-only, then throw an
+Line 645 
 object is read-only, then throw an
  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>
- ** Definition groups
+ <p>The definition group
+ <dfn id=DeclaredValueType><code>DeclaredValueType</code></dfn> contains
+ integers indicating the declared type of attributes.</p>
+ <table>
+ <thead>
+ <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
+ </thead>
+ <tbody>
+ <tr>
+ <th scope=row><dfn id=NO_TYPE_ATTR class=dom-const><code>NO_TYPE_ATTR</code>
+ <td><code>0</code><td>No value <span class=ed>[INFOSET]</span>.</tr>
+ <tr>
+ <th scope=row><dfn id=CDATA_ATTR class=dom-const><code>CDATA_ATTR</code>
+ <td><code>1</code><td><code>CDATA</code> <span class=ed>[XML]</span>.</tr>
+ <tr>
+ <th scope=row><dfn id=ID_ATTR class=dom-const><code>ID_ATTR</code>
+ <td><code>2</code><td><code>ID</code> <span class=ed>[XML]</span>.</tr>
+ <tr>
+ <th scope=row><dfn id=IDREF_ATTR class=dom-const><code>IDREF_ATTR</code>
+ <td><code>3</code><td><code>IDREF</code> <span class=ed>[XML]</span>.</tr>
+ <tr>
+ <th scope=row><dfn id=IDREFS_ATTR class=dom-const><code>IDREFS_ATTR</code>
+ <td><code>4</code><td><code>IDREFS</code> <span class=ed>[XML]</span>.</tr>
+ <tr>
+ <th scope=row><dfn id=ENTITY_ATTR class=dom-const><code>ENTITY_ATTR</code>
+ <td><code>5</code><td><code>ENTITY</code> <span class=ed>[XML]</span>.</tr>
+ <tr>
+ <th scope=row><dfn id=ENTITIES_ATTR class=dom-const><code>ENTITIES_ATTR</code>
+ <td><code>6</code><td><code>ENTITIES</code> <span class=ed>[XML]</span>.</tr>
+ <tr>
+ <th scope=row><dfn id=NMTOKEN_ATTR class=dom-const><code>NMTOKEN_ATTR</code>
+ <td><code>7</code><td><code>NMTOKEN</code> <span class=ed>[XML]</span>.</tr>
+ <tr>
+ <th scope=row><dfn id=NMTOKENS_ATTR class=dom-const><code>NMTOKENS_ATTR</code>
+ <td><code>8</code><td><code>NMTOKENS</code> <span class=ed>[XML]</span>.</tr>
+ <tr>
+ <th scope=row><dfn id=NOTATION_ATTR class=dom-const><code>NOTATION_ATTR</code>
+ <td><code>9</code><td><code>NOTATION</code> <span class=ed>[XML]</span>.</tr>
+ <tr>
+ <th scope=row><dfn id=ENUMERATION_ATTR class=dom-const><code>ENUMERATION_ATTR</code>
+ <td><code>10</code><td>Enumeration <span class=ed>[XML]</span>.</tr>
+ <tr>
+ <th scope=row><dfn id=UNKNOWN_ATTR class=dom-const><code>UNKNOWN_ATTR</code>
+ <td><code>11</code><td>Unknown, because no declaration for the attribute
+ has been read but the [all declaration processed] property
+ <span class=ed>[INFOSET]</span> would be false.</tr>
+ </tbody>
+ </table>
+ <p>If no attribute type information is available, or if the source
+ of the information does not distinguish <q>no value</q> and <q>unknown</q>
+ <span class=ed>[INFOSET]</span>, then the value
+ <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>
+ <em class=rfc2119>MUST</em> be used.</p>
+ <div class="note memo">
+ <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
+ created by the
+ <a href="#createAttributeDefinition"><code>createAttributeDefinition</code></a>
+ method has its <a href="#declaredType"><code>declaredType</code></a> attribute
+ set to <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</p>
+ </div>
- [6] The
+ <p>If the source of the information does not distinguish <q>no value</q>
- [DFN@en[definition group [CODE(DOM)@en[[[DeclaredValueType]]]]]]
+ and/or <code>unknown</code> <span class=ed>[INFOSET]</span> and
- contains integers indicating the type of
+ <code>CDATA</code> <span class=ed>[XML]</span>, then the value
- attribute value:
+ <a href="#CDATA_ATTR"><code>CDATA_ATTR</code></a> <em class=rfc2119>MUST</em>
- ,[CODE(DOMc)@en[[[NO_TYPE_ATTR]]]],[CODE(IDL)[[[0]]]],The attribute value type corresponding to [[no value]] in XML Information Set.
+ be used.</p>
- ,[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]]]].
+ <p>In Perl binding <span class=ed>[PERLBINDING]</span>, the
- ,[CODE(DOMc)@en[[[IDREF_ATTR]]]],[CODE(IDL)[[[3]]]],The attribute value type is [CODE(XML)@en[[[IDREF]]]].
+ <code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the
- ,[CODE(DOMc)@en[[[IDREFS_ATTR]]]],[CODE(IDL)[[[4]]]],The attribute value type is [CODE(XML)@en[[[IDREFS]]]].
+ <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>
- ,[CODE(DOMc)@en[[[ENTITY_ATTR]]]],[CODE(IDL)[[[5]]]],The attribute value type is [CODE(XML)@en[[[ENTITY]]]].
+ constant group.</p>
- ,[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.
+ <pre class=ed>
  [7] The
  [DFN@en[definition group [CODE(DOM)@en[[[DefaultValueType]]]]]]
  contains integers indicating the type of

 Legend:



Removed from v.1.7
 


changed lines


 
Added in v.1.9
 Legend:



Removed from v.1.7
 


changed lines


 
Added in v.1.9
-Removed from v.1.7
+Added in v.1.9

admin@suikawiki.org	ViewVC Help
Powered by ViewVC 1.1.24