/[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.13 by wakaba,
Mon Dec  3 11:57:22 2007 UTC
+revision 1.15 by wakaba,
Tue Dec  4 10:43:12 2007 UTC
 Line 174 
 feature names with or without version nu
  aforementioned cases.</p>
  </div>
+ <div class=section id=section-node>
+ <h3>Modifications to the <code id=Node>Node</code> Interface</h3>
+ <p>The implementation of the
+ <a href="#Node"><code>Node</code></a> interface
+ <em class=rfc2119>MUST</em> be modified as following:</p>
+ <pre class=idl><code>// Additions to the Node interface
+ // Additions to the NodeType definition group
+ const unsigned short <a href="#ELEMENT_TYPE_DEFINITION_NODE">ELEMENT_TYPE_DEFINITION_NODE</a> = 81001;
+ const unsigned short <a href="#ATTRIBUTE_DEFINITION_NODE">ATTRIBUTE_DEFINITION_NODE</a> = 81002;
+ </pre>
+ <p>This specification adds two new types (subinterfaces) of
+ <a href="#Node"><code>Node</code></a>: element type definition (node type
+ <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>,
+ interface
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) and
+ attribute definition (node type
+ <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>,
+ interface
+ <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>).  For
+ these kinds of nodes, methods and attributes in the
+ <a href="#Node"><code>Node</code></a> interface must behave as following:</p>
+ <dl>
+ <dt><code id=attributes>attributes</code></dt>
+   <dd>
+     <p>On getting, the attribute <em class=rfc2119>MUST</em> return
+     <code>null</code>.</p>
+   </dd>
+ <dt><code id=baseURI>baseURI</code></dt>
+   <dd>
+     <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
+     value of the <a href="#baseURI"><code>baseURI</code></a> attribute
+     of the node in the <code>ownerDocument</code> attribute of the node.
+     Note that the value might be <code>null</code>.</p>
+   </dd>
+ <dt><code id=nodeName>nodeName</code></dt>
+   <dd>
+     <p>If the node is an
+     <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
+     On getting, the attribute <em class=rfc2119>MUST</em> return the
+     name of the element type definition represented by the node.</p>
+     <p>If the node is an
+     <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:
+     On getting, the attribute <em class=rfc2119>MUST</em> return the
+     name of the attribute definition represented by the node.</p>
+   </dd>
+ <dt><code id=nodeType>nodeType</code></dt>
+   <dd>
+     <p>On getting, the attribute <em class=rfc2119>MUST</em> return
+     <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>
+     (if the node is an
+     <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) or
+     <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>
+     (if the node is an
+     <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>).</p>
+     <!-- NodeType -->
+ <p>Two constants are added to the <code id=NodeType>NodeType</code>
+ definition group of the <a href="#Node"><code>Node</code></a> interface as
+ following:</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=ELEMENT_TYPE_DEFINITION_NODE class=dom-const><code>ELEMENT_TYPE_DEFINITION_NODE</code></dfn>
+ <td><code>81001</code><td>The node is an
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>.</tr>
+ <tr>
+ <th scope=row><dfn id=ATTRIBUTE_DEFINITION_NODE class=dom-const><code>ATTRIBUTE_DEFINITION_NODE</code></dfn>
+ <td><code>81002</code><td>The node is an
+ <a href="#ElementTypeDefinition"><code>AttributeDefinition</code></a>.</tr>
+ </tbody>
+ </table>
+   </dd>
+ <dt><code id=nodeValue>nodeValue</code> and
+ <code id=textContent>textContent</code></dt>
+   <dd>
+     <p>If the node is an
+     <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
+     On getting, the attributes <em class=rfc2119>MUST</em> return the
+     name of the element type.</p>
+     <div class="note memo">
+       <p>Thus, on setting the attributes does nothing
+       <span class=ed>[DOM3]</span>.</p>
+     </div>
+     <p>On setting, the <a href="#textContent"><code>textContent</code></a>
+     attribute <em class=rfc2119>MUST NOT</em> raise a
+     <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>.
+     <span class=ed>@@ I forgot why this requirement is necessary.</span></p>
+     <p>If the node is an
+     <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:</p>
+     <pre class=ed>
+ The getter of the [CODE(DOMa)@en[[[nodeValue]]]] attribute
+ of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
+ [['''MUST''']] return the normalized default value
+ of the attribute.
+ @@
+ [4] The getter of the [CODE(DOMa)@en[[[textContent]]]]
+ attribute of an [CODE(DOMi)@en[[[AttributeDefinition]]]]
+ object [['''MUST''']] behave as if it were an
+ [CODE(DOMi)@en[[[Attr]]]] object.
+ The setter of the [CODE(DOMa)@en[[[textContent]]]] attribute
+ of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
+ [['''MUST''']] behave as if the following algorithm
+ is performed:
+ = If the [CODE(DOMi)@en[[[AttributeDefinition]]]]
+ object is read-only, then throw an
+ [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].
+ = Remove any child node the node has.
+ = If the new value is not empty and not [CODE(IDL)@en[[[null]]]],
+ then create a [CODE(DOMi)@en[[[Text]]]] node
+ whose [CODE(DOMa)@en[[[data]]]] is the new value
+ and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].
+ </pre>
+   </dd>
+ <dt class=ed>@@ ...</dt>
+ </dl>
+ </div>
  <div class=section id=section-documentxdoctype>
  <h3>The <code>DocumentXDoctype</code> Interface</h3>
+ <p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface
+ <em class=rfc2119>MUST</em> be implemented as following:</p>
  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {
    DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>
      (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)
-Line 408 
 define it for <code>Document</code> meth
+Line 543 
 define it for <code>Document</code> meth
  <div class=section id=section-documenttypedefinition>
  <h3>The <code>DocumentTypeDefinition</code> Interface</h3>
+ <p>The
+ <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
+ interface <em class=rfc2119>MUST</em> be implemented as following:</p>
  <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>;
-Line 555 
 reflected by that of the object.
+Line 693 
 reflected by that of the object.
  <div class=section id=section-elementtypedefinition>
  <h3>The <code>ElementTypeDefinition</code> Interface</h3>
+ <p>The <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
+ interface <em class=rfc2119>MUST</em> be implemented as following:</p>
  <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
+ <pre class=ed>
- [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute
- of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object
- [['''MUST''']] return [CODE(IDL)@en[[[null]]]].
- [4] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute
- of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object
- [['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]
- of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the
- [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object.
- Note that it might be [CODE(IDL)@en[[[null]]]].
- [1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute
- of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object
- [['''MUST''']] return the name of the element type.
- [2] The getters of the [CODE(DOMa)@en[[[nodeValue]]]]
- and [CODE(DOMa)@en[[[textContent]]]] attributes
- of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
- object [['''MUST''']] return [CODE(IDL)@en[[[null]]]].
- ;; Thus, the setter of these attributes do nothing.
- The setter of the [CODE(DOMa)@en[[[textContent]]]]
- attribute of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
- object [['''MUST NOT''']] throw a
- [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].
- ** The [CODE(DOMi)@en[ElementTypeDefinition]] Interface
- [5] The
  [DFN@en[[CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute]]
  of the [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
  interface is defined in [[manakai//DOM Extensions]>>50].</pre>
-Line 601 
 interface is defined in [[manakai//DOM E
+Line 710 
 interface is defined in [[manakai//DOM E
  <div class=section id=section-attributedefinition>
  <h3>The <code>AttributeDefinition</code> Interface</h3>
+ <p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
+ interface <em class=rfc2119>MUST</em> be implemented as following:</p>
  <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;
-Line 624 
 interface is defined in [[manakai//DOM E
+Line 735 
 interface is defined in [[manakai//DOM E
    <span class=ed>...</span>
  }</code></pre>
- <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members
- [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute
- of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
- [['''MUST''']] return [CODE(IDL)@en[[[null]]]].
- [9] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute
- of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
- [['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]
- of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the
- [CODE(DOMi)@en[[[AttributeDefinition]]]] object.
- Note that it might be [CODE(IDL)@en[[[null]]]].
- [1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute
- of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
- [['''MUST''']] return the name of the attribute.
- [2] The getter of the [CODE(DOMa)@en[[[nodeValue]]]] attribute
- of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
- [['''MUST''']] return the normalized default value
- of the attribute.
- @@
- [4] The getter of the [CODE(DOMa)@en[[[textContent]]]]
- attribute of an [CODE(DOMi)@en[[[AttributeDefinition]]]]
- object [['''MUST''']] behave as if it were an
- [CODE(DOMi)@en[[[Attr]]]] object.
- The setter of the [CODE(DOMa)@en[[[textContent]]]] attribute
- of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
- [['''MUST''']] behave as if the following algorithm
- is performed:
- = If the [CODE(DOMi)@en[[[AttributeDefinition]]]]
- object is read-only, then throw an
- [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].
- = Remove any child node the node has.
- = If the new value is not empty and not [CODE(IDL)@en[[[null]]]],
- then create a [CODE(DOMi)@en[[[Text]]]] node
- whose [CODE(DOMa)@en[[[data]]]] is the new value
- and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].
- </pre>
  <dl>
  <dt><dfn id=ownerElementTypeDefinition class=dom-attr><code>ownerElementTypeDefinition</code></dfn>
  of type
-Line 899 
 information items created from the
+Line 967 
 information items created from the
  in the <code>NodeList</code> object in the <code>childNodes</code> attribute
  of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
+ <p>The implementation of the
+ <a href="#DocumentType"><code>DocumentType</code></a> interface
+ <em class=rfc2119>MUST</em> be modified as following:</p>
  <pre class=idl><code>// Modifications to the DocumentType interface
    attribute DOMString <a href="#publicId">publicId</a>;
    attribute DOMString <a href="#systemId">systemId</a>;

 Legend:



Removed from v.1.13
 


changed lines


 
Added in v.1.15
 Legend:



Removed from v.1.13
 


changed lines


 
Added in v.1.15
-Removed from v.1.13
+Added in v.1.15

admin@suikawiki.org	ViewVC Help
Powered by ViewVC 1.1.24