/[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.12 by wakaba,
Mon Dec  3 11:04:29 2007 UTC
 Line 10
  <div class="header">
  <h1>DOM Document Type Definition Module</h1>
- <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>
  <dl class="versions-uri">
  <dt>This Version</dt>
 Line 125 
 raised is undefined.</p>
  interface.</p>
  <p class=ed>@@ ref to DOM Binding Spec</p>
+ <p>If the <code>strictErrorChecking</code> attribute of the
+ <code>Document</code> node is <code>false</code>, the methods are
+ not required to raise exceptions <span class=ed>[DOM3]</span>.</p>
  </div>
  <div class=section id=dom-dtdef>
-Line 139 
 consists of three interfaces:</p>
+Line 143 
 consists of three interfaces:</p>
  <li><a href="#AttributeDefinition"><code>AttributeDefinition</code></a></li>
  </ul>
- <p>In addition, it adds methods, attributes, and/or constants to interfaces
+ <p>In addition, it modifies interfaces
  <a href="#Node"><code>Node</code></a>,
+ <a href="#DocumentType"><code>DocumentType</code></a>,
  <a href="#Entity"><code>Entity</code></a>,
- <a href="#EntityReference"><code>EntityReference</code></a>, and
+ <a href="#EntityReference"><code>EntityReference</code></a>,
- <a href="#Notation"><code>Notation</code></a>.
+ <a href="#Notation"><code>Notation</code></a>, and
- It modifies semantics of some of methods and attributes in
+ <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>.</p>
- <a href="#Node"><code>Node</code></a> and
- <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
- interfaces, for the support of new interfaces.</p>
  <div class=section id=features>
  <h3>Feature Name</h3>
-Line 179 
 aforementioned cases.</p>
+Line 181 
 aforementioned cases.</p>
    DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>
      (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)
      raises (DOMException);
-   ElementTypeDefinition <a href="#createElementTypeDefinition">createElementTypeDefinition</a>
+   <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#createElementTypeDefinition">createElementTypeDefinition</a>
      (in DOMString <a href="#createElementTypeDefinition-name"><var>name</var></a>)
      raises (DOMException);
-   AttributeDefinition <a href="#createAttributeDefinition">createAttributeDefinition</a>
+   <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#createAttributeDefinition">createAttributeDefinition</a>
      (in DOMString <a href="#createAttributeDefinition-name"><var>name</var></a>)
      raises (DOMException);
-   Entity <a href="#createGeneralEntity">createGeneralEntityDefinition</a>
+   <a href="#Entity">Entity</a> <a href="#createGeneralEntity">createGeneralEntityDefinition</a>
      (in DOMString <a href="#createGeneralEntity-name"><var>name</var></a>)
      raises (DOMException);
-   Notation <a href="#createNotation">createNotation</a>
+   <a href="#Notation">Notation</a> <a href="#createNotation">createNotation</a>
      (in DOMString <a href="#createNotation-name"><var>name</var></a>)
      raises (DOMException);
  }</code></pre>
-Line 399 
 since <abbr>DOM3</abbr> specification <s
+Line 401 
 since <abbr>DOM3</abbr> specification <s
  define it for <code>Document</code> methods.</p>
  <p><var>name</var> does not have to be a namespace qualified name.</p>
- <p>If the <code>strictErrorChecking</code> attribute of the
- <code>Document</code> node is <code>false</code>, the methods are
- not required to raise the exception <span class=ed>[DOM3]</span>.</p>
  </div>
  </div>
-Line 411 
 not required to raise the exception <spa
+Line 409 
 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 423 
 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 484 
 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 525 
 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>
  <h3>The <code>ElementTypeDefinition</code> Interface</h3>
- <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> {
+   readonly attribute <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
+   <span class=ed>@@ more</span>
  }</code></pre>
  <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members
-Line 575 
 interface is defined in [[manakai//DOM E
+Line 586 
 interface is defined in [[manakai//DOM E
  <div class=section id=section-attributedefinition>
  <h3>The <code>AttributeDefinition</code> Interface</h3>
- <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> {
+   <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;
+   readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;
+   readonly attribute unsigned short <a href="#declaredType">declaredType</a>;
+   readonly attribute unsigned short <a href="#defaultType">defaultType</a>;
+   <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 650 
 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>
+ <dl>
+ <dt><dfn id=ownerElementTypeDefinition class=dom-attr><code>ownerElementTypeDefinition</code></dfn>
+ of type
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
+ read$B!>(Bonly</dt>
+   <dd><p>The
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> to
+   which the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
+   node belongs.</p>
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return an
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.
+   It <em class=rfc2119>MUST</em> be such a node that whose
+   <a href="#attributeDefinitons"><code>attributeDefinitions</code></a>
+   attribute contains the <code>NamedNodeMap</code> object that contains
+   the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
+   node.  If there is no such an
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node,
+   then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p>
+ <dt><dfn id=declaredType class=dom-attr><code>declaredType</code></dfn> of type
+ <code>unsigned short</code></dt>
+   <dd><p>The declared type <span class=ed>@@ ref</span> of the attribute.
+   It is expected that this attribute contains a value from the definition group
+   <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>.</p>
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
+   value associated to this attribute.</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
+   <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> 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 this attribute.</p>
+   <p>If the <code>AttributeDefinition</code> node is created during the process
+   to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, an
+   appropriate value from the
+   <a href="#DeclaredValueType"><code>DeclaredValueType</code></a> constant
+   group <em class=rfc2119>MUST</em> be set to the attribute.</p>
+   <!-- DeclaredValueType -->
+ <p>The definition group
+ <dfn id=DeclaredValueType><code>DeclaredValueType</code></dfn> contains
+ integers indicating the declared type of attributes.  The definition
+ group contains the following constants:</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>
+ <p>If the source of the information does not distinguish <q>no value</q>
+ and/or <q>unknown</q> <span class=ed>[INFOSET]</span> and
+ <code>CDATA</code> <span class=ed>[XML]</span>, then the value
+ <a href="#CDATA_ATTR"><code>CDATA_ATTR</code></a> <em class=rfc2119>MUST</em>
+ be used.</p>
+ <p>In Perl binding <span class=ed>[PERLBINDING]</span>, the
+ <code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the
+ <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>
+ definition group.</p>
+   </dd>
+ <dt><dfn id=defaultType class=dom-attr><code>defaultType</code></dfn> of
+ type <code>unsigned short</code></dt>
+   <dd><p>The type of the default for the attribute.  It is expected that this
+   attribute contains a value from the definition group
+   <a href="#DefaultValueType"><code>DefaultValueType</code></a>.</p>
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return
+   the value associated to this attribute.</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
+   <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> 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 this attribute.</p>
+   <p>If the
+   <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node is
+   created during the process to create a <abbr>DOM</abbr> from an
+   <abbr>XML</abbr> document, an appropriate value from the
+   <a href="#DefaultValueType"><code>DefaultValueType</code></a> definition
+   group <em class=rfc2119>MUST</em> be set to the attribute.</p>
+   <!-- DefaultValueType -->
+   <p>The definition group
+   <dfn id=DefaultValueType><code>DefaultValueType</code></dfn>
+   contains integers indicating the type of the default for the attribute.
+   The definition group contains the following constans:</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=UNKNOWN_DEFAULT class=dom-const><code>UNKNOWN_DEFAULT</code></dfn>
+   <td><code>0</code><td>Unknown.</tr>
+   <tr>
+   <th scope=row><dfn id=FIXED_DEFAULT class=dom-const><code>FIXED_DEFAULT</code></dfn>
+   <td><code>1</code><td>Provided explicitly and fixed
+   <span class=ed>@@ ref</span> to that value.</tr>
+   <tr>
+   <th scope=row><dfn id=REQUIRED_DEFAULT class=dom-const><code>REQUIRED_DEFAULT</code></dfn>
+   <td><code>2</code><td>No default value and the attribute have to be
+   explicitly specified.</tr>
+   <tr>
+   <th scope=row><dfn id=IMPLIED_DEFAULT class=dom-const><code>IMPLIED_DEFAULT</code></dfn>
+   <td><code>3</code><td>Implied <span class=ed>@@ ref</span>.</tr>
+   <tr>
+   <th scope=row><dfn id=EXPLICIT_DEFAULT class=dom-const><code>EXPLICIT_DEFAULT</code></dfn>
+   <td><code>4</code><td>Provided explicitly.</tr>
+   </tbody>
+   </table>
+   <p>If the source of the default type does not distinguish
+   implied and unknown default types, then the value
+   <a href="#IMPLIED_DEFAULT"><code>IMPLIED_DEFAULT</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="#defaultType"><code>defaultType</code></a>
+   attribute set to
+   <a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</p>
+   </div></dd>
+ </dl>
+ </div>
- ** Definition groups
+ <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>;
+ </code></pre>
+ <p class=ed>
+  The publicId attribute and the systemId attribute of DocumentType, Entity, and Notation objects are now read-write.
+ The setter MUST throw a NO_MODIFICATION_ALLOWED_ERR DOMException if the Node object is read-only. Otherwise, it MUST set the specified value to the attribute. No normalization, lexical validation, or relative reference resolving is performed. null, which represents no public or system identifier is provided, might be specified.
+ Setting public or system identifier does never result in any lexical or logical structure of the document being changed. In particular, no external entity referenced by new identifier will be loaded.
+ Setting an invalid or non-normalized identifier might make the object non-serializable. Setting a non-null public identifier to a DocumentType or Entity object that does not have non-null system identifier or setting null as the system identifier of a DocumentType or Entity object that does have non-null public identifier will make that object non-serializable.
+ ISSUE: In HTML5, Firefox 1.5, and Opera 9, not specifying public or system identifier results in empty strings.
+ </pre>
- [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>
  </div>
  </div>

 Legend:



Removed from v.1.7
 


changed lines


 
Added in v.1.12
 Legend:



Removed from v.1.7
 


changed lines


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

admin@suikawiki.org	ViewVC Help
Powered by ViewVC 1.1.24