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> |
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> |
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> |
|
|
|
|
<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]]]]. |
|
|
</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> |
|
775 |
|
|
776 |
<p>On getting, the attribute <em class=rfc2119>MUST</em> return the |
</dd> |
|
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></dd> |
|
777 |
<dt><dfn id=defaultType class=dom-attr><code>defaultType</code></dfn> of |
<dt><dfn id=defaultType class=dom-attr><code>defaultType</code></dfn> of |
778 |
type <code>unsigned short</code></dt> |
type <code>unsigned short</code></dt> |
779 |
<dd><p>The type of the default for the attribute. It is expected that this |
<dd><p>The type of the default for the attribute. It is expected that this |
794 |
<p>If the <code>AttributeDefinition</code> node is created during the process |
<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 |
to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, an |
796 |
appropriate value from the |
appropriate value from the |
797 |
<a href="#DefaultValueType"><code>DefaultValueType</code></a> constant |
<a href="#DefaultValueType"><code>DefaultValueType</code></a> definition |
798 |
group <em class=rfc2119>MUST</em> be set to the attribute.</p></dd> |
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> |
</dl> |
845 |
|
|
846 |
</div> |
</div> |