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> |
125 |
interface.</p> |
interface.</p> |
126 |
|
|
127 |
<p class=ed>@@ ref to DOM Binding Spec</p> |
<p class=ed>@@ ref to DOM Binding Spec</p> |
128 |
|
|
129 |
|
<p>If the <code>strictErrorChecking</code> attribute of the |
130 |
|
<code>Document</code> node is <code>false</code>, the methods are |
131 |
|
not required to raise exceptions <span class=ed>[DOM3]</span>.</p> |
132 |
</div> |
</div> |
133 |
|
|
134 |
<div class=section id=dom-dtdef> |
<div class=section id=dom-dtdef> |
143 |
<li><a href="#AttributeDefinition"><code>AttributeDefinition</code></a></li> |
<li><a href="#AttributeDefinition"><code>AttributeDefinition</code></a></li> |
144 |
</ul> |
</ul> |
145 |
|
|
146 |
<p>In addition, it adds methods, attributes, and/or constants to interfaces |
<p>In addition, it modifies interfaces |
147 |
<a href="#Node"><code>Node</code></a>, |
<a href="#Node"><code>Node</code></a>, |
148 |
|
<a href="#DocumentType"><code>DocumentType</code></a>, |
149 |
<a href="#Entity"><code>Entity</code></a>, |
<a href="#Entity"><code>Entity</code></a>, |
150 |
<a href="#EntityReference"><code>EntityReference</code></a>, and |
<a href="#EntityReference"><code>EntityReference</code></a>, |
151 |
<a href="#Notation"><code>Notation</code></a>. |
<a href="#Notation"><code>Notation</code></a>, and |
152 |
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> |
|
153 |
|
|
154 |
<div class=section id=features> |
<div class=section id=features> |
155 |
<h3>Feature Name</h3> |
<h3>Feature Name</h3> |
181 |
DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a> |
DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a> |
182 |
(in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>) |
(in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>) |
183 |
raises (DOMException); |
raises (DOMException); |
184 |
ElementTypeDefinition <a href="#createElementTypeDefinition">createElementTypeDefinition</a> |
<a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#createElementTypeDefinition">createElementTypeDefinition</a> |
185 |
(in DOMString <a href="#createElementTypeDefinition-name"><var>name</var></a>) |
(in DOMString <a href="#createElementTypeDefinition-name"><var>name</var></a>) |
186 |
raises (DOMException); |
raises (DOMException); |
187 |
AttributeDefinition <a href="#createAttributeDefinition">createAttributeDefinition</a> |
<a href="#AttributeDefinition">AttributeDefinition</a> <a href="#createAttributeDefinition">createAttributeDefinition</a> |
188 |
(in DOMString <a href="#createAttributeDefinition-name"><var>name</var></a>) |
(in DOMString <a href="#createAttributeDefinition-name"><var>name</var></a>) |
189 |
raises (DOMException); |
raises (DOMException); |
190 |
Entity <a href="#createGeneralEntity">createGeneralEntityDefinition</a> |
<a href="#Entity">Entity</a> <a href="#createGeneralEntity">createGeneralEntityDefinition</a> |
191 |
(in DOMString <a href="#createGeneralEntity-name"><var>name</var></a>) |
(in DOMString <a href="#createGeneralEntity-name"><var>name</var></a>) |
192 |
raises (DOMException); |
raises (DOMException); |
193 |
Notation <a href="#createNotation">createNotation</a> |
<a href="#Notation">Notation</a> <a href="#createNotation">createNotation</a> |
194 |
(in DOMString <a href="#createNotation-name"><var>name</var></a>) |
(in DOMString <a href="#createNotation-name"><var>name</var></a>) |
195 |
raises (DOMException); |
raises (DOMException); |
196 |
}</code></pre> |
}</code></pre> |
401 |
define it for <code>Document</code> methods.</p> |
define it for <code>Document</code> methods.</p> |
402 |
|
|
403 |
<p><var>name</var> does not have to be a namespace qualified name.</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> |
|
404 |
</div> |
</div> |
405 |
|
|
406 |
</div> |
</div> |
413 |
readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>; |
readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>; |
414 |
readonly attribute NamedNodeMap <a href="#notations">notations</a>; |
readonly attribute NamedNodeMap <a href="#notations">notations</a>; |
415 |
|
|
416 |
<span class=ed>more members come here...</span> |
<a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#getElementTypeDefinitionNode">getElementTypeDefinitionNode</a> |
417 |
|
(in DOMString <a href="#getElementTypeDefinitionNode-name"><var>name</var></a>); |
418 |
|
<a href="#Entity">Entity</a> <a href="#getGeneralEntityNode">getGeneralEntityNode</a> |
419 |
|
(in DOMString <a href="#getGeneralEntityNode-name"><var>name</var></a>); |
420 |
|
<a href="#Notation">Notation</a> <a href="#getNotationNode">getNotationNode</a> |
421 |
|
(in DOMString <a href="#getNotationNode-name"><var>name</var></a>); |
422 |
|
|
423 |
|
void <a href="#setElementTypeDefinitionNode">setElementTypeDefinitionNode</a> |
424 |
|
(in DOMString <a href="#setElementTypeDefinitionNode-node"><var>node</var></a>) |
425 |
|
raises (DOMException); |
426 |
|
void <a href="#setGeneralEntityNode">setGeneralEntityNode</a> |
427 |
|
(in DOMString <a href="#setGeneralEntityNode-node"><var>node</var></a>) |
428 |
|
raises (DOMException); |
429 |
|
void <a href="#setNotationNode">setNotationNode</a> |
430 |
|
(in DOMString <a href="#setNotationNode-node"><var>node</var></a>) |
431 |
|
raises (DOMException); |
432 |
}</code></pre> |
}</code></pre> |
433 |
|
|
434 |
<pre class=ed> |
<pre class=ed> |
555 |
<div class=section id=section-elementtypedefinition> |
<div class=section id=section-elementtypedefinition> |
556 |
<h3>The <code>ElementTypeDefinition</code> Interface</h3> |
<h3>The <code>ElementTypeDefinition</code> Interface</h3> |
557 |
|
|
558 |
<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> { |
559 |
|
readonly attribute <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>; |
560 |
|
|
561 |
|
<span class=ed>@@ more</span> |
562 |
}</code></pre> |
}</code></pre> |
563 |
|
|
564 |
<pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members |
<pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members |
601 |
<div class=section id=section-attributedefinition> |
<div class=section id=section-attributedefinition> |
602 |
<h3>The <code>AttributeDefinition</code> Interface</h3> |
<h3>The <code>AttributeDefinition</code> Interface</h3> |
603 |
|
|
604 |
<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> { |
605 |
<span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span> |
<span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span> |
606 |
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; |
607 |
const unsigned short <a href="#CDATA_ATTR">CDATA_ATTR</a> = 1; |
const unsigned short <a href="#CDATA_ATTR">CDATA_ATTR</a> = 1; |
616 |
const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10; |
const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10; |
617 |
const unsigned short <a href="#UNKNOWN_ATTR">UNKNOWN_ATTR</a> = 11; |
const unsigned short <a href="#UNKNOWN_ATTR">UNKNOWN_ATTR</a> = 11; |
618 |
|
|
619 |
|
readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>; |
620 |
|
|
621 |
|
readonly attribute unsigned short <a href="#declaredType">declaredType</a>; |
622 |
|
readonly attribute unsigned short <a href="#defaultType">defaultType</a>; |
623 |
|
|
624 |
<span class=ed>...</span> |
<span class=ed>...</span> |
625 |
}</code></pre> |
}</code></pre> |
626 |
|
|
667 |
and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]]. |
and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]]. |
668 |
</pre> |
</pre> |
669 |
|
|
670 |
|
<dl> |
671 |
|
<dt><dfn id=ownerElementTypeDefinition class=dom-attr><code>ownerElementTypeDefinition</code></dfn> |
672 |
|
of type |
673 |
|
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>, |
674 |
|
read$B!>(Bonly</dt> |
675 |
|
<dd><p>The |
676 |
|
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> to |
677 |
|
which the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
678 |
|
node belongs.</p> |
679 |
|
|
680 |
|
<p>On getting, the attribute <em class=rfc2119>MUST</em> return an |
681 |
|
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node. |
682 |
|
It <em class=rfc2119>MUST</em> be such a node that whose |
683 |
|
<a href="#attributeDefinitons"><code>attributeDefinitions</code></a> |
684 |
|
attribute contains the <code>NamedNodeMap</code> object that contains |
685 |
|
the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
686 |
|
node. If there is no such an |
687 |
|
<a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node, |
688 |
|
then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p> |
689 |
|
<dt><dfn id=declaredType class=dom-attr><code>declaredType</code></dfn> of type |
690 |
|
<code>unsigned short</code></dt> |
691 |
|
<dd><p>The declared type <span class=ed>@@ ref</span> of the attribute. |
692 |
|
It is expected that this attribute contains a value from the definition group |
693 |
|
<a href="#DeclaredValueType"><code>DeclaredValueType</code></a>.</p> |
694 |
|
|
695 |
|
<p>On getting, the attribute <em class=rfc2119>MUST</em> return the |
696 |
|
value associated to this attribute.</p> |
697 |
|
|
698 |
|
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
699 |
|
<code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span> |
700 |
|
exception if the |
701 |
|
<a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node |
702 |
|
is read$B!>(Bonly <span class=ed>@@ ref</span>. Otherwise, it |
703 |
|
<em class=rfc2119>MUST</em> set the specified value as the value |
704 |
|
associated to this attribute.</p> |
705 |
|
|
706 |
|
<p>If the <code>AttributeDefinition</code> node is created during the process |
707 |
|
to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, an |
708 |
|
appropriate value from the |
709 |
|
<a href="#DeclaredValueType"><code>DeclaredValueType</code></a> constant |
710 |
|
group <em class=rfc2119>MUST</em> be set to the attribute.</p> |
711 |
|
|
712 |
|
<!-- DeclaredValueType --> |
713 |
<p>The definition group |
<p>The definition group |
714 |
<dfn id=DeclaredValueType><code>DeclaredValueType</code></dfn> contains |
<dfn id=DeclaredValueType><code>DeclaredValueType</code></dfn> contains |
715 |
integers indicating the declared type of attributes.</p> |
integers indicating the declared type of attributes. The definition |
716 |
|
group contains the following constants:</p> |
717 |
|
|
718 |
<table> |
<table> |
719 |
<thead> |
<thead> |
776 |
</div> |
</div> |
777 |
|
|
778 |
<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> |
779 |
and/or <code>unknown</code> <span class=ed>[INFOSET]</span> and |
and/or <q>unknown</q> <span class=ed>[INFOSET]</span> and |
780 |
<code>CDATA</code> <span class=ed>[XML]</span>, then the value |
<code>CDATA</code> <span class=ed>[XML]</span>, then the value |
781 |
<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> |
782 |
be used.</p> |
be used.</p> |
784 |
<p>In Perl binding <span class=ed>[PERLBINDING]</span>, the |
<p>In Perl binding <span class=ed>[PERLBINDING]</span>, the |
785 |
<code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the |
<code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the |
786 |
<a href="#DeclaredValueType"><code>DeclaredValueType</code></a> |
<a href="#DeclaredValueType"><code>DeclaredValueType</code></a> |
787 |
constant group.</p> |
definition group.</p> |
788 |
|
|
789 |
|
</dd> |
790 |
|
<dt><dfn id=defaultType class=dom-attr><code>defaultType</code></dfn> of |
791 |
|
type <code>unsigned short</code></dt> |
792 |
|
<dd><p>The type of the default for the attribute. It is expected that this |
793 |
|
attribute contains a value from the definition group |
794 |
|
<a href="#DefaultValueType"><code>DefaultValueType</code></a>.</p> |
795 |
|
|
796 |
|
<p>On getting, the attribute <em class=rfc2119>MUST</em> return |
797 |
|
the value associated to this attribute.</p> |
798 |
|
|
799 |
|
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
800 |
|
<code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span> |
801 |
|
exception if the |
802 |
|
<a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node |
803 |
|
is read$B!>(Bonly <span class=ed>@@ ref</span>. Otherwise, it |
804 |
|
<em class=rfc2119>MUST</em> set the specified value as the value |
805 |
|
associated to this attribute.</p> |
806 |
|
|
807 |
|
<p>If the |
808 |
|
<a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node is |
809 |
|
created during the process to create a <abbr>DOM</abbr> from an |
810 |
|
<abbr>XML</abbr> document, an appropriate value from the |
811 |
|
<a href="#DefaultValueType"><code>DefaultValueType</code></a> definition |
812 |
|
group <em class=rfc2119>MUST</em> be set to the attribute.</p> |
813 |
|
|
814 |
|
<!-- DefaultValueType --> |
815 |
|
<p>The definition group |
816 |
|
<dfn id=DefaultValueType><code>DefaultValueType</code></dfn> |
817 |
|
contains integers indicating the type of the default for the attribute. |
818 |
|
The definition group contains the following constans:</p> |
819 |
|
|
820 |
|
<table> |
821 |
|
<thead> |
822 |
|
<tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr> |
823 |
|
</thead> |
824 |
|
<tbody> |
825 |
|
<tr> |
826 |
|
<th scope=row><dfn id=UNKNOWN_DEFAULT class=dom-const><code>UNKNOWN_DEFAULT</code></dfn> |
827 |
|
<td><code>0</code><td>Unknown.</tr> |
828 |
|
<tr> |
829 |
|
<th scope=row><dfn id=FIXED_DEFAULT class=dom-const><code>FIXED_DEFAULT</code></dfn> |
830 |
|
<td><code>1</code><td>Provided explicitly and fixed |
831 |
|
<span class=ed>@@ ref</span> to that value.</tr> |
832 |
|
<tr> |
833 |
|
<th scope=row><dfn id=REQUIRED_DEFAULT class=dom-const><code>REQUIRED_DEFAULT</code></dfn> |
834 |
|
<td><code>2</code><td>No default value and the attribute have to be |
835 |
|
explicitly specified.</tr> |
836 |
|
<tr> |
837 |
|
<th scope=row><dfn id=IMPLIED_DEFAULT class=dom-const><code>IMPLIED_DEFAULT</code></dfn> |
838 |
|
<td><code>3</code><td>Implied <span class=ed>@@ ref</span>.</tr> |
839 |
|
<tr> |
840 |
|
<th scope=row><dfn id=EXPLICIT_DEFAULT class=dom-const><code>EXPLICIT_DEFAULT</code></dfn> |
841 |
|
<td><code>4</code><td>Provided explicitly.</tr> |
842 |
|
</tbody> |
843 |
|
</table> |
844 |
|
|
845 |
|
<p>If the source of the default type does not distinguish |
846 |
|
implied and unknown default types, then the value |
847 |
|
<a href="#IMPLIED_DEFAULT"><code>IMPLIED_DEFAULT</code></a> |
848 |
|
<em class=rfc2119>MUST</em> be used.</p> |
849 |
|
|
850 |
|
<div class="note memo"> |
851 |
|
<p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> |
852 |
|
node created by the |
853 |
|
<a href="#createAttributeDefinition"><code>createAttributeDefinition</code></a> |
854 |
|
method has its <a href="#defaultType"><code>defaultType</code></a> |
855 |
|
attribute set to |
856 |
|
<a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</p> |
857 |
|
</div></dd> |
858 |
|
</dl> |
859 |
|
|
860 |
|
</div> |
861 |
|
|
862 |
|
<div class=section id=section-documenttype> |
863 |
|
<h3>Modifications to the <code id=DocumentType>DocumentType</code> |
864 |
|
Interface</h3> |
865 |
|
|
866 |
|
<p>A <a href="#DocumentType"><code>DocumentType</code></a> interface |
867 |
|
<em class=rfc2119>MAY</em> contain zero or more |
868 |
|
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> |
869 |
|
nodes in the <code>NodeList</code> object contained in the |
870 |
|
<code>childNodes</code> attribute of the |
871 |
|
<a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
872 |
|
|
873 |
|
<p>If the <a href="#DocumentType"><code>DocumentType</code></a> node is created |
874 |
|
during the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> |
875 |
|
document, the <code>NodeList</code> object in the <code>childNodes</code> |
876 |
|
object <em class=rfc2119>MUST</em> contains the |
877 |
|
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> |
878 |
|
nodes representing the processing instructions in the document type |
879 |
|
definition of the document processed <span class=ed>@@ ref</span> by |
880 |
|
the <abbr>XML</abbr> processor. If the |
881 |
|
<a href="#DocumentType"><code>DocumentType</code></a> node is marked |
882 |
|
as read$B!>(Bonly, then all the child nodes <em class=rfc2119>MUST</em> |
883 |
|
also be marked as read$B!>(Bonly.</p> |
884 |
|
|
885 |
|
<p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is created |
886 |
|
from a document type declaration information item <span class=ed>@@ ref</span>, |
887 |
|
the <code>NodeList</code> object in the <code>childNodes</code> attribute |
888 |
|
of the node <em class=rfc2119>MUST</em> contain the |
889 |
|
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes |
890 |
|
created from the processing instruction information items in the list in the |
891 |
|
[children] property of the document type declaration item in the same |
892 |
|
order.</p> |
893 |
|
|
894 |
|
<p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is mapped to |
895 |
|
a document type declaration information item, the list in the [children] |
896 |
|
property <em class=rfc2119>MUST</em> contain the processng instruction |
897 |
|
information items created from the |
898 |
|
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes |
899 |
|
in the <code>NodeList</code> object in the <code>childNodes</code> attribute |
900 |
|
of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p> |
901 |
|
|
902 |
|
<pre class=idl><code>// Modifications to the DocumentType interface |
903 |
|
attribute DOMString <a href="#publicId">publicId</a>; |
904 |
|
attribute DOMString <a href="#systemId">systemId</a>; |
905 |
|
|
906 |
|
attribute DOMString <a href="#internalSubset">internalSubset</a>; |
907 |
|
</code></pre> |
908 |
|
|
909 |
|
<p>The <code id=publicId>publicId</code> attribute and the |
910 |
|
<code id=systemId>systemId</code> attribute of |
911 |
|
<a href="#DocumentType"><code>DocumentType</code></a>, |
912 |
|
<a href="#Entity"><code>Entity</code></a>, and |
913 |
|
<a href="#Notation"><code>Notation</code></a> interfaces are no longer |
914 |
|
read$B!>(Bonly.</p> |
915 |
|
|
916 |
|
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
917 |
|
<code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span> |
918 |
|
exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>. |
919 |
|
Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value |
920 |
|
associated to the attribute. No normalization, relative reference resolution, |
921 |
|
or lexical validation is performed. <span class=ed>@@ If the new |
922 |
|
value is <code>null</code>, ...</span></p> |
923 |
|
|
924 |
|
<div class="note memo"> |
925 |
|
<p>Setting an invalid identifier might make the node unserializable. |
926 |
|
Setting a public identifier while leaveing system identifier unspecified |
927 |
|
would also make the <a href="#DocumentType"><code>DocumentType</code></a> |
928 |
|
or <a href="#Entity"><code>Entity</code></a> node unserializable.</p> |
929 |
|
</div> |
930 |
|
|
931 |
|
<div class=ed> |
932 |
|
<p>ISSUE: In HTML5, Firefox 1.5, and Opera 9, not specifying public or system identifier results in empty strings.</p> |
933 |
|
</div> |
934 |
|
|
935 |
|
<p>The <code id=internalSubset>internalSubset</code> attribute of the |
936 |
|
<a href="#DocumentType"><code>DocumentType</code></a> interface is no longer |
937 |
|
read$B!>(Bonly.</p> |
938 |
|
|
939 |
|
<p>On setting, the attribute <em class=rfc2119>MUST</em> raise a |
940 |
|
<code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span> |
941 |
|
exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>. |
942 |
|
Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value |
943 |
|
associated to the attribute. No normalization, or lexical validation is |
944 |
|
performed. <span class=ed>@@ If the new value is <code>null</code>, |
945 |
|
...</span></p> |
946 |
|
|
|
<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> |
|
947 |
</div> |
</div> |
948 |
|
|
949 |
</div> |
</div> |