587 |
<h3>The <code>AttributeDefinition</code> Interface</h3> |
<h3>The <code>AttributeDefinition</code> Interface</h3> |
588 |
|
|
589 |
<pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> { |
<pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> { |
590 |
|
<span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span> |
591 |
|
const unsigned short <a href="#NO_TYPE_ATTR">NO_TYPE_ATTR</a> = 0; |
592 |
|
const unsigned short <a href="#CDATA_ATTR">CDATA_ATTR</a> = 1; |
593 |
|
const unsigned short <a href="#ID_ATTR">ID_ATTR</a> = 2; |
594 |
|
const unsigned short <a href="#IDREF_ATTR">IDREF_ATTR</a> = 3; |
595 |
|
const unsigned short <a href="#IDREFS_ATTR">IDREFS_ATTR</a> = 4; |
596 |
|
const unsigned short <a href="#ENTITY_ATTR">ENTITY_ATTR</a> = 5; |
597 |
|
const unsigned short <a href="#ENTITIES_ATTR">ENTITIES_ATTR</a> = 6; |
598 |
|
const unsigned short <a href="#NMTOKEN_ATTR">NMTOKEN_ATTR</a> = 7; |
599 |
|
const unsigned short <a href="#NMTOKENS_ATTR">NMTOKENS_ATTR</a> = 8; |
600 |
|
const unsigned short <a href="#NOTATION_ATTR">NOTATION_ATTR</a> = 9; |
601 |
|
const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10; |
602 |
|
const unsigned short <a href="#UNKNOWN_ATTR">UNKNOWN_ATTR</a> = 11; |
603 |
|
|
604 |
|
<span class=ed>...</span> |
605 |
}</code></pre> |
}</code></pre> |
606 |
|
|
607 |
<pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members |
<pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members |
645 |
then create a [CODE(DOMi)@en[[[Text]]]] node |
then create a [CODE(DOMi)@en[[[Text]]]] node |
646 |
whose [CODE(DOMa)@en[[[data]]]] is the new value |
whose [CODE(DOMa)@en[[[data]]]] is the new value |
647 |
and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]]. |
and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]]. |
648 |
|
</pre> |
649 |
|
|
650 |
** Definition groups |
<p>The definition group |
651 |
|
<dfn id=DeclaredValueType><code>DeclaredValueType</code></dfn> contains |
652 |
[6] The |
integers indicating the declared type of attributes.</p> |
653 |
[DFN@en[definition group [CODE(DOM)@en[[[DeclaredValueType]]]]]] |
|
654 |
contains integers indicating the type of |
<table> |
655 |
attribute value: |
<thead> |
656 |
,[CODE(DOMc)@en[[[NO_TYPE_ATTR]]]],[CODE(IDL)[[[0]]]],The attribute value type corresponding to [[no value]] in XML Information Set. |
<tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr> |
657 |
,[CODE(DOMc)@en[[[CDATA_ATTR]]]],[CODE(IDL)[[[1]]]],The attribute value type is [CODE(XML)@en[[[CDATA]]]]. |
</thead> |
658 |
,[CODE(DOMc)@en[[[ID_ATTR]]]],[CODE(IDL)[[[2]]]],The attribute value type is [CODE(XML)@en[[[ID]]]]. |
<tbody> |
659 |
,[CODE(DOMc)@en[[[IDREF_ATTR]]]],[CODE(IDL)[[[3]]]],The attribute value type is [CODE(XML)@en[[[IDREF]]]]. |
<tr> |
660 |
,[CODE(DOMc)@en[[[IDREFS_ATTR]]]],[CODE(IDL)[[[4]]]],The attribute value type is [CODE(XML)@en[[[IDREFS]]]]. |
<th scope=row><dfn id=NO_TYPE_ATTR class=dom-const><code>NO_TYPE_ATTR</code> |
661 |
,[CODE(DOMc)@en[[[ENTITY_ATTR]]]],[CODE(IDL)[[[5]]]],The attribute value type is [CODE(XML)@en[[[ENTITY]]]]. |
<td><code>0</code><td>No value <span class=ed>[INFOSET]</span>.</tr> |
662 |
,[CODE(DOMc)@en[[[ENTITIES_ATTR]]]],[CODE(IDL)[[[6]]]],The attribute value type is [CODE(XML)@en[[[ENTITIES]]]]. |
<tr> |
663 |
,[CODE(DOMc)@en[[[NMTOKEN_ATTR]]]],[CODE(IDL)[[[7]]]],The attribute value type is [CODE(XML)@en[[[NMTOKEN]]]]. |
<th scope=row><dfn id=CDATA_ATTR class=dom-const><code>CDATA_ATTR</code> |
664 |
,[CODE(DOMc)@en[[[NMTOKENS_ATTR]]]],[CODE(IDL)[[[8]]]],The attribute value type is [CODE(XML)@en[[[NMTOKENS]]]]. |
<td><code>1</code><td><code>CDATA</code> <span class=ed>[XML]</span>.</tr> |
665 |
,[CODE(DOMc)@en[[[NOTATION_ATTR]]]],[CODE(IDL)[[[9]]]],The attribute value type is [CODE(XML)@en[[[NOTATION]]]]. |
<tr> |
666 |
,[CODE(DOMc)@en[[[ENUMERATION_ATTR]]]],[CODE(IDL)[[[10]]]],The attribute value is enumeration type. |
<th scope=row><dfn id=ID_ATTR class=dom-const><code>ID_ATTR</code> |
667 |
,[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." |
<td><code>2</code><td><code>ID</code> <span class=ed>[XML]</span>.</tr> |
668 |
|
<tr> |
669 |
The type of these constants are |
<th scope=row><dfn id=IDREF_ATTR class=dom-const><code>IDREF_ATTR</code> |
670 |
[CODE(IDL)@en[[[unsigned]] [[short]]]]. |
<td><code>3</code><td><code>IDREF</code> <span class=ed>[XML]</span>.</tr> |
671 |
|
<tr> |
672 |
If no attribute type information is provided, |
<th scope=row><dfn id=IDREFS_ATTR class=dom-const><code>IDREFS_ATTR</code> |
673 |
or if the source of that information does not |
<td><code>4</code><td><code>IDREFS</code> <span class=ed>[XML]</span>.</tr> |
674 |
distinguish [[no value]] and [[unknown]] as in |
<tr> |
675 |
XML Information Set, then the |
<th scope=row><dfn id=ENTITY_ATTR class=dom-const><code>ENTITY_ATTR</code> |
676 |
[CODE(DOMc)@en[[[NO_TYPE_ATTR]]]] value |
<td><code>5</code><td><code>ENTITY</code> <span class=ed>[XML]</span>.</tr> |
677 |
[['''MUST''']] be used. |
<tr> |
678 |
|
<th scope=row><dfn id=ENTITIES_ATTR class=dom-const><code>ENTITIES_ATTR</code> |
679 |
;; A newly created [CODE(DOMi)@en[[[AttributeDefinition]]]] |
<td><code>6</code><td><code>ENTITIES</code> <span class=ed>[XML]</span>.</tr> |
680 |
object by [CODE(DOMm)@en[[[createAttributeDefinition]]]] |
<tr> |
681 |
method has [CODE(DOMa)@en[[[declaredType]]]] attribute |
<th scope=row><dfn id=NMTOKEN_ATTR class=dom-const><code>NMTOKEN_ATTR</code> |
682 |
set to [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]]. |
<td><code>7</code><td><code>NMTOKEN</code> <span class=ed>[XML]</span>.</tr> |
683 |
|
<tr> |
684 |
If the source of the attribute type information |
<th scope=row><dfn id=NMTOKENS_ATTR class=dom-const><code>NMTOKENS_ATTR</code> |
685 |
does not distinguish [[no value]] and / or [[unknown]] |
<td><code>8</code><td><code>NMTOKENS</code> <span class=ed>[XML]</span>.</tr> |
686 |
and [CODE(XML)@en[[[CDATA]]]], then the |
<tr> |
687 |
[CODE(DOMc)@en[[[CDATA_ATTR]]]] value [['''MUST''']] |
<th scope=row><dfn id=NOTATION_ATTR class=dom-const><code>NOTATION_ATTR</code> |
688 |
be used. |
<td><code>9</code><td><code>NOTATION</code> <span class=ed>[XML]</span>.</tr> |
689 |
|
<tr> |
690 |
[11] |
<th scope=row><dfn id=ENUMERATION_ATTR class=dom-const><code>ENUMERATION_ATTR</code> |
691 |
In Perl binding, the objects implementing the |
<td><code>10</code><td>Enumeration <span class=ed>[XML]</span>.</tr> |
692 |
[CODE(DOMi)@en[[[Attr]]]] interface [['''MUST''']] |
<tr> |
693 |
also implement the [CODE(DOM)@en[[[DeclaredValueType]]]] |
<th scope=row><dfn id=UNKNOWN_ATTR class=dom-const><code>UNKNOWN_ATTR</code> |
694 |
constant group. |
<td><code>11</code><td>Unknown, because no declaration for the attribute |
695 |
|
has been read but the [all declaration processed] property |
696 |
|
<span class=ed>[INFOSET]</span> would be false.</tr> |
697 |
|
</tbody> |
698 |
|
</table> |
699 |
|
|
700 |
|
<p>If no attribute type information is available, or if the source |
701 |
|
of the information does not distinguish <q>no value</q> and <q>unknown</q> |
702 |
|
<span class=ed>[INFOSET]</span>, then the value |
703 |
|
<a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a> |
704 |
|
<em class=rfc2119>MUST</em> be used.</p> |
705 |
|
|
706 |
|
<div class="note memo"> |
707 |
|
<p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node |
708 |
|
created by the |
709 |
|
<a href="#createAttributeDefinition"><code>createAttributeDefinition</code></a> |
710 |
|
method has its <a href="#declaredType"><code>declaredType</code></a> attribute |
711 |
|
set to <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</p> |
712 |
|
</div> |
713 |
|
|
714 |
|
<p>If the source of the information does not distinguish <q>no value</q> |
715 |
|
and/or <code>unknown</code> <span class=ed>[INFOSET]</span> and |
716 |
|
<code>CDATA</code> <span class=ed>[XML]</span>, then the value |
717 |
|
<a href="#CDATA_ATTR"><code>CDATA_ATTR</code></a> <em class=rfc2119>MUST</em> |
718 |
|
be used.</p> |
719 |
|
|
720 |
|
<p>In Perl binding <span class=ed>[PERLBINDING]</span>, the |
721 |
|
<code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the |
722 |
|
<a href="#DeclaredValueType"><code>DeclaredValueType</code></a> |
723 |
|
constant group.</p> |
724 |
|
|
725 |
|
<pre class=ed> |
726 |
[7] The |
[7] The |
727 |
[DFN@en[definition group [CODE(DOM)@en[[[DefaultValueType]]]]]] |
[DFN@en[definition group [CODE(DOM)@en[[[DefaultValueType]]]]]] |
728 |
contains integers indicating the type of |
contains integers indicating the type of |