Browse files

[] (0) WF2: <select> -- the beginnings. Also: typo fixes, fix <input …

…size> definition to make better use of rfc2119 terms, and move .labels in the IDL down to after the CVA stuff, so that it matches the order in the prose.

git-svn-id: http://svn.whatwg.org/webapps@2285 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
1 parent b74ba69 commit c3be9ca8f847d874b9a6740d9b2db211fb2b2afc @Hixie Hixie committed Oct 6, 2008
Showing with 179 additions and 42 deletions.
  1. +90 −24 index
  2. +89 −18 source
View
114 index
@@ -16,7 +16,7 @@
<div class=head>
<p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
<h1>HTML 5</h1>
- <h2 class="no-num no-toc" id=draft-recommendation-&mdash;-date:-01-jan-1901>Draft Recommendation &mdash; 5 October 2008</h2>
+ <h2 class="no-num no-toc" id=draft-recommendation-&mdash;-date:-01-jan-1901>Draft Recommendation &mdash; 6 October 2008</h2>
<p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<dl><dt>Multiple-page version:</dt>
@@ -17286,7 +17286,7 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
<p>The <dfn id=effective-loop-start><var>effective loop start</var></dfn> is the smaller of
the <code title=dom-media-loopStart><a href=#dom-media-loopstart>loopStart</a></code> DOM attribute
- and the end of the <a href=#media-resource>media resource</a>.<p>
+ and the end of the <a href=#media-resource>media resource</a>.</p>
<p>The <dfn id=attr-media-loopend title=attr-media-loopend><code>loopend</code></dfn>
content attribute gives an offset into the <a href=#media-resource>media
@@ -17298,7 +17298,7 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
<p>The <dfn id=effective-loop-end><var>effective loop end</var></dfn> is the greater of
the <code title=dom-media-start><a href=#dom-media-start>start</a></code>, <code title=dom-media-loopStart><a href=#dom-media-loopstart>loopStart</a></code>, and <code title=dom-media-loopEnd><a href=#dom-media-loopend>loopEnd</a></code> DOM attributes, except if
that is greater than the end of the <a href=#media-resource>media resource</a>, in
- which case that's its value.<p>
+ which case that's its value.</p>
<p>The <dfn id=attr-media-end title=attr-media-end><code>end</code></dfn> content
attribute gives an offset into the <a href=#media-resource>media resource</a> at
@@ -17307,7 +17307,7 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
<p>The <dfn id=effective-end><var>effective end</var></dfn> is the greater of the
<code title=dom-media-start><a href=#dom-media-start>start</a></code>, <code title=dom-media-loopStart><a href=#dom-media-loopstart>loopStart</a></code>, and <code title=dom-media-loopEnd><a href=#dom-media-loopend>end</a></code> DOM attributes, except if that
is greater than the end of the <a href=#media-resource>media resource</a>, in which
- case that's its value.<p>
+ case that's its value.</p>
<p>The <code title=attr-media-start><a href=#attr-media-start>start</a></code>, <code title=attr-media-loopstart><a href=#attr-media-loopstart>loopstart</a></code>, <code title=attr-media-loopend><a href=#attr-media-loopend>loopend</a></code>, and <code title=attr-media-end><a href=#attr-media-end>end</a></code> attributes must, if specified,
contain <span title="value time offset">value time
@@ -22976,8 +22976,6 @@ function AddCloud(data, x, y) { ... }</pre>
attribute float <a href=#dom-input-valueasnumber title=dom-input-valueAsNumber>valueAsNumber</a>;
readonly attribute <a href=#htmloptionelement>HTMLOptionElement</a> <a href=#dom-input-selectedoption title=dom-input-selectedOption>selectedOption</a>;
- readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
-
void <a href=#dom-input-stepup title=dom-input-stepUp>stepUp</a>(in int n);
void <a href=#dom-input-stepdown title=dom-input-stepDown>stepDown</a>(in int n);
@@ -22986,6 +22984,8 @@ function AddCloud(data, x, y) { ... }</pre>
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidatity title=dom-cva-checkValidatity>checkValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(in DOMString error);
+
+ readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
};</pre>
</dd>
</dl><!-- XXX add selectionStart and company --><p>The <code><a href=#the-input-element>input</a></code> element represents a typed data field,
@@ -25744,12 +25744,21 @@ function AddCloud(data, x, y) { ... }</pre>
<h6 id=the-size-attribute><span class=secno>4.10.4.2.4 </span>The <code title=attr-input-size><a href=#attr-input-size>size</a></code> attribute</h6>
<p>The <dfn id=attr-input-size title=attr-input-size><code>size</code></dfn>
- attribute, if specified, must have a value that is a <a href=#valid-non-negative-integer>valid
- non-negative integer</a> greater than zero.</p>
+ attribute gives the number of characters that, in a visual
+ rendering, the user agent is to allow the user to see while editing
+ the element's <a href=#concept-fe-value title=concept-fe-value>value</a>.</p>
- <p>The attribute's value gives the number of characters that, in a
- visual rendering, the user agent should allow the user to see while
- editing the element's <a href=#concept-fe-value title=concept-fe-value>value</a>.</p>
+ <p>The <code title=attr-input-size><a href=#attr-input-size>size</a></code> attribute, if
+ specified, must have a value that is a <a href=#valid-non-negative-integer>valid non-negative
+ integer</a> greater than zero.</p>
+
+ <p>If the attribute is present, then its value must be parsed using
+ the <a href=#rules-for-parsing-non-negative-integers>rules for parsing non-negative integers</a>, and if the
+ result is a number greater than zero, then the user agent should
+ ensure that at least that many characters are visible.</p>
+
+ <p class=XXX>The rendering section will define this in more
+ detail.</p>
<p>The <code title=dom-input-size><a href=#dom-input-size>size</a></code> DOM attribute
<a href=#limited-to-only-positive-non-zero-numbers>limited to only positive non-zero numbers</a>.</p>
@@ -26156,13 +26165,13 @@ function AddCloud(data, x, y) { ... }</pre>
attribute DOMString <a href=#dom-button-type title=dom-button-type>type</a>;
attribute DOMString <a href=#dom-button-value title=dom-button-value>value</a>;
- readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
-
readonly attribute boolean <a href=#dom-cva-willvalidate title=dom-cva-willValidate>willValidate</a>;
readonly attribute <span>ValidityState</span> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidatity title=dom-cva-checkValidatity>checkValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(in DOMString error);
+
+ readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
};</pre>
</dd>
</dl><p>The <code><a href=#the-button-element>button</a></code> element represents a button. If the
@@ -26257,18 +26266,18 @@ function AddCloud(data, x, y) { ... }</pre>
<dd><code title=attr-fe-autofocus><a href=#attr-fe-autofocus>autofocus</a></code></dd>
<dd><code title=attr-fe-disabled><a href=#attr-fe-disabled>disabled</a></code></dd>
<dd><code title=attr-fae-form><a href=#attr-fae-form>form</a></code></dd>
- <dd><code title=attr-select-multiple>multiple</code></dd>
+ <dd><code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code></dd>
<dd><code title=attr-fe-name><a href=#attr-fe-name>name</a></code></dd>
- <dd><code title=attr-select-size>size</code></dd>
+ <dd><code title=attr-select-size><a href=#attr-select-size>size</a></code></dd>
<dt>DOM interface:</dt>
<dd>
<pre class=idl>interface <dfn id=htmlselectelement>HTMLSelectElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
attribute boolean <a href=#dom-fe-autofocus title=dom-fe-autofocus>autofocus</a>;
attribute boolean <a href=#dom-fe-disabled title=dom-fe-disabled>disabled</a>;
readonly attribute <a href=#htmlformelement>HTMLFormElement</a> <a href=#dom-fae-form title=dom-fae-form>form</a>;
- attribute boolean <span title=dom-select-multiple>multiple</span>;
+ attribute boolean <a href=#dom-select-multiple title=dom-select-multiple>multiple</a>;
attribute DOMString <a href=#dom-fe-name title=dom-fe-name>name</a>;
- attribute boolean <span title=dom-select-size>size</span>;
+ attribute boolean <a href=#dom-select-size title=dom-select-size>size</a>;
readonly attribute DOMString <span title=dom-select-type>type</span>;
@@ -26280,8 +26289,6 @@ function AddCloud(data, x, y) { ... }</pre>
attribute long <span title=dom-select-selectedIndex>selectedIndex</span>;
attribute DOMString <span title=dom-select-value>value</span>;
- readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
-
void <span title=dom-select-add>add</span>(in <a href=#htmlelement>HTMLElement</a> element, in <a href=#htmlelement>HTMLElement</a> before);
void <span title=dom-select-remove>remove</span>(in long index);
@@ -26290,9 +26297,45 @@ function AddCloud(data, x, y) { ... }</pre>
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidatity title=dom-cva-checkValidatity>checkValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(in DOMString error);
+
+ readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
};</pre>
</dd>
- </dl><p class=XXX>...</p>
+ </dl><p>The <code><a href=#the-select-element>select</a></code> element represents a control for
+ selecting amongst a set of options.</p>
+
+ <p>The <dfn id=attr-select-multiple title=attr-select-multiple><code>multiple</code></dfn>
+ attribute is a <a href=#boolean-attribute>boolean attribute</a>. If the attribute is
+ present, then the <code><a href=#the-select-element>select</a></code> element represents a control
+ for selecting zero or more options from the <a href=#select-option-list title=select-option-list>list of options</a>. If the attribute
+ is absent, then the <code><a href=#the-select-element>select</a></code> element represents a control
+ for selecting a single option from the <a href=#select-option-list title=select-option-list>list of options</a>.</p>
+
+ <p>The <dfn id=select-option-list title=select-option-list>list of options</dfn> for a
+ <code><a href=#the-select-element>select</a></code> element consists of all the <code><a href=#the-option-element>option</a></code>
+ element children of the <code><a href=#the-select-element>select</a></code> element, and all the
+ <code><a href=#the-option-element>option</a></code> element children of all the
+ <code><a href=#the-optgroup-element>optgroup</a></code> element children of the <code><a href=#the-select-element>select</a></code>
+ element, in <a href=#tree-order>tree order</a>.</p>
+
+ <p>The <dfn id=attr-select-size title=attr-select-size><code>size</code></dfn>
+ attribute gives the number of options to show to the user. The <code title=attr-input-size><a href=#attr-input-size>size</a></code> attribute, if specified, must
+ have a value that is a <a href=#valid-non-negative-integer>valid non-negative integer</a>
+ greater than zero. If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is present,
+ then the <code title=attr-input-size><a href=#attr-input-size>size</a></code> attribute's
+ default value is 4. If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is absent,
+ then the <code title=attr-input-size><a href=#attr-input-size>size</a></code> attribute's
+ default value is 1.</p>
+
+ <!-- XXX for the rendering section
+ <p>If the <code title="attr-select-multiple">multiple</code>
+ attribute is absent, and either the <code
+ title="attr-input-size">size</code> attribute is also absent or
+ parsing its value using the <span>rules for parsing non-negative
+ integers</span> returns 1, 0, or an error, then the control should
+ be rendered as a drop-down select box. Otherwise, it should be
+ rendered as a list select box.</p>
+ -->
<p>The <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute is used to
explicitly associate the <code><a href=#the-select-element>select</a></code> element with its
@@ -26302,6 +26345,29 @@ function AddCloud(data, x, y) { ... }</pre>
submitted. The <code title=attr-fe-autofocus><a href=#attr-fe-autofocus>autofocus</a></code>
attribute controls focus.</p>
+ <p class=XXX>...</p>
+
+ <!-- XXX
+ readonly attribute DOMString <span title="dom-select-type">type</span>;
+
+ readonly attribute <span>HTMLOptionsCollection</span> <span title="dom-select-options">options</span>;
+ attribute unsigned long <span title="dom-select-length">length</span>;
+ [IndexGetter] <span>HTMLElement</span> <span title="dom-select-XXX9">XXX9</span>(in unsigned long index);
+
+ readonly attribute <span>HTMLOptionsCollection</span> <span title="dom-select-selectedOptions">selectedOptions</span>;
+ attribute long <span title="dom-select-selectedIndex">selectedIndex</span>;
+ attribute DOMString <span title="dom-select-value">value</span>;
+
+ void <span title="dom-select-add">add</span>(in <span>HTMLElement</span> element, in <span>HTMLElement</span> before);
+ void <span title="dom-select-remove">remove</span>(in long index);
+ -->
+
+ <p>The <dfn id=dom-select-multiple title=dom-select-multiple><code>multiple</code></dfn>
+ and <dfn id=dom-select-size title=dom-select-size><code>size</code></dfn> DOM
+ attributes must <a href=#reflect>reflect</a> the respective content
+ attributes of the same name. The <code title=dom-select-size><a href=#dom-select-size>size</a></code> DOM attribute <a href=#limited-to-only-positive-non-zero-numbers>limited to
+ only positive non-zero numbers</a>.</p>
+
<p>The <code title=dom-cva-willValidate><a href=#dom-cva-willvalidate>willValidate</a></code>, <code title=dom-cva-validity><a href=#dom-cva-validity>validity</a></code>, and <code title=dom-cva-validationMessage><a href=#dom-cva-validationmessage>validationMessage</a></code>
attributes, and the <code title=dom-cva-checkValidatity><a href=#dom-cva-checkvalidatity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
methods, are part of the <a href=#the-constraint-validation-api>constraint validation API</a>. The
@@ -26445,13 +26511,13 @@ interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href=#htmleleme
attribute DOMString <span title=dom-textarea-defaultValue>defaultValue</span>;
attribute DOMString <span title=dom-textarea-value>value</span>;
- readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
-
readonly attribute boolean <a href=#dom-cva-willvalidate title=dom-cva-willValidate>willValidate</a>;
readonly attribute <span>ValidityState</span> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidatity title=dom-cva-checkValidatity>checkValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(in DOMString error);
+
+ readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
};</pre>
</dd>
</dl><!-- XXX add selectionStart and company --><p class=XXX>...</p>
@@ -28291,7 +28357,7 @@ http://mail.gnome.org/archives/usability/2006-June/msg00015.html
<dd>
<p>If the first element child of a cell's element is a
- <code><a href=#the-select-element>select</a></code> element that has a no <code title=attr-select-multiple>multiple</code> attribute and has at
+ <code><a href=#the-select-element>select</a></code> element that has a no <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute and has at
least one <code><a href=#the-option-element>option</a></code> element descendent, then the cell
acts as a cyclable cell.</p>
@@ -29985,7 +30051,7 @@ menu li:not(:first-child)::before { content: ' | '; }</pre>
<p>The <a href=#command-facet-type title=command-facet-Type>Type</a> of the command
is "radio" if the <code><a href=#the-option-element>option</a></code>'s nearest ancestor
- <code><a href=#the-select-element>select</a></code> element has no <code title=attr-select-multiple>multiple</code> attribute, and
+ <code><a href=#the-select-element>select</a></code> element has no <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute, and
"checkbox" if it does.</p>
<p>The <a href=#command-facet-id title=command-facet-ID>ID</a> of the command is
View
107 source
@@ -18495,7 +18495,7 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {
<p>The <dfn><var>effective loop start</var></dfn> is the smaller of
the <code title="dom-media-loopStart">loopStart</code> DOM attribute
- and the end of the <span>media resource</span>.<p>
+ and the end of the <span>media resource</span>.</p>
<p>The <dfn title="attr-media-loopend"><code>loopend</code></dfn>
content attribute gives an offset into the <span>media
@@ -18511,7 +18511,7 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {
title="dom-media-loopStart">loopStart</code>, and <code
title="dom-media-loopEnd">loopEnd</code> DOM attributes, except if
that is greater than the end of the <span>media resource</span>, in
- which case that's its value.<p>
+ which case that's its value.</p>
<p>The <dfn title="attr-media-end"><code>end</code></dfn> content
attribute gives an offset into the <span>media resource</span> at
@@ -18522,7 +18522,7 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {
title="dom-media-loopStart">loopStart</code>, and <code
title="dom-media-loopEnd">end</code> DOM attributes, except if that
is greater than the end of the <span>media resource</span>, in which
- case that's its value.<p>
+ case that's its value.</p>
<p>The <code title="attr-media-start">start</code>, <code
title="attr-media-loopstart">loopstart</code>, <code
@@ -25483,8 +25483,6 @@ function AddCloud(data, x, y) { ... }</pre>
attribute float <span title="dom-input-valueAsNumber">valueAsNumber</span>;
readonly attribute <span>HTMLOptionElement</span> <span title="dom-input-selectedOption">selectedOption</span>;
- readonly attribute <span>NodeList</span> <span title="dom-lfe-labels">labels</span>;
-
void <span title="dom-input-stepUp">stepUp</span>(in int n);
void <span title="dom-input-stepDown">stepDown</span>(in int n);
@@ -25493,6 +25491,8 @@ function AddCloud(data, x, y) { ... }</pre>
readonly attribute DOMString <span title="dom-cva-validationMessage">validationMessage</span>;
boolean <span title="dom-cva-checkValidatity">checkValidity</span>();
void <span title="dom-cva-setCustomValidity">setCustomValidity</span>(in DOMString error);
+
+ readonly attribute <span>NodeList</span> <span title="dom-lfe-labels">labels</span>;
};</pre>
</dd>
</dl>
@@ -28690,13 +28690,21 @@ function AddCloud(data, x, y) { ... }</pre>
<h6>The <code title="attr-input-size">size</code> attribute</h6>
<p>The <dfn title="attr-input-size"><code>size</code></dfn>
- attribute, if specified, must have a value that is a <span>valid
- non-negative integer</span> greater than zero.</p>
+ attribute gives the number of characters that, in a visual
+ rendering, the user agent is to allow the user to see while editing
+ the element's <span title="concept-fe-value">value</span>.</p>
- <p>The attribute's value gives the number of characters that, in a
- visual rendering, the user agent should allow the user to see while
- editing the element's <span
- title="concept-fe-value">value</span>.</p>
+ <p>The <code title="attr-input-size">size</code> attribute, if
+ specified, must have a value that is a <span>valid non-negative
+ integer</span> greater than zero.</p>
+
+ <p>If the attribute is present, then its value must be parsed using
+ the <span>rules for parsing non-negative integers</span>, and if the
+ result is a number greater than zero, then the user agent should
+ ensure that at least that many characters are visible.</p>
+
+ <p class="XXX">The rendering section will define this in more
+ detail.</p>
<p>The <code title="dom-input-size">size</code> DOM attribute
<span>limited to only positive non-zero numbers</span>.</p>
@@ -29233,13 +29241,13 @@ function AddCloud(data, x, y) { ... }</pre>
attribute DOMString <span title="dom-button-type">type</span>;
attribute DOMString <span title="dom-button-value">value</span>;
- readonly attribute <span>NodeList</span> <span title="dom-lfe-labels">labels</span>;
-
readonly attribute boolean <span title="dom-cva-willValidate">willValidate</span>;
readonly attribute <span>ValidityState</span> <span title="dom-cva-validity">validity</span>;
readonly attribute DOMString <span title="dom-cva-validationMessage">validationMessage</span>;
boolean <span title="dom-cva-checkValidatity">checkValidity</span>();
void <span title="dom-cva-setCustomValidity">setCustomValidity</span>(in DOMString error);
+
+ readonly attribute <span>NodeList</span> <span title="dom-lfe-labels">labels</span>;
};</pre>
</dd>
</dl>
@@ -29385,8 +29393,6 @@ function AddCloud(data, x, y) { ... }</pre>
attribute long <span title="dom-select-selectedIndex">selectedIndex</span>;
attribute DOMString <span title="dom-select-value">value</span>;
- readonly attribute <span>NodeList</span> <span title="dom-lfe-labels">labels</span>;
-
void <span title="dom-select-add">add</span>(in <span>HTMLElement</span> element, in <span>HTMLElement</span> before);
void <span title="dom-select-remove">remove</span>(in long index);
@@ -29395,11 +29401,52 @@ function AddCloud(data, x, y) { ... }</pre>
readonly attribute DOMString <span title="dom-cva-validationMessage">validationMessage</span>;
boolean <span title="dom-cva-checkValidatity">checkValidity</span>();
void <span title="dom-cva-setCustomValidity">setCustomValidity</span>(in DOMString error);
+
+ readonly attribute <span>NodeList</span> <span title="dom-lfe-labels">labels</span>;
};</pre>
</dd>
</dl>
- <p class="XXX">...</p>
+ <p>The <code>select</code> element represents a control for
+ selecting amongst a set of options.</p>
+
+ <p>The <dfn title="attr-select-multiple"><code>multiple</code></dfn>
+ attribute is a <span>boolean attribute</span>. If the attribute is
+ present, then the <code>select</code> element represents a control
+ for selecting zero or more options from the <span
+ title="select-option-list">list of options</span>. If the attribute
+ is absent, then the <code>select</code> element represents a control
+ for selecting a single option from the <span
+ title="select-option-list">list of options</span>.</p>
+
+ <p>The <dfn title="select-option-list">list of options</dfn> for a
+ <code>select</code> element consists of all the <code>option</code>
+ element children of the <code>select</code> element, and all the
+ <code>option</code> element children of all the
+ <code>optgroup</code> element children of the <code>select</code>
+ element, in <span>tree order</span>.</p>
+
+ <p>The <dfn title="attr-select-size"><code>size</code></dfn>
+ attribute gives the number of options to show to the user. The <code
+ title="attr-input-size">size</code> attribute, if specified, must
+ have a value that is a <span>valid non-negative integer</span>
+ greater than zero. If the <code
+ title="attr-select-multiple">multiple</code> attribute is present,
+ then the <code title="attr-input-size">size</code> attribute's
+ default value is 4. If the <code
+ title="attr-select-multiple">multiple</code> attribute is absent,
+ then the <code title="attr-input-size">size</code> attribute's
+ default value is 1.</p>
+
+ <!-- XXX for the rendering section
+ <p>If the <code title="attr-select-multiple">multiple</code>
+ attribute is absent, and either the <code
+ title="attr-input-size">size</code> attribute is also absent or
+ parsing its value using the <span>rules for parsing non-negative
+ integers</span> returns 1, 0, or an error, then the control should
+ be rendered as a drop-down select box. Otherwise, it should be
+ rendered as a list select box.</p>
+ -->
<p>The <code title="attr-fae-form">form</code> attribute is used to
explicitly associate the <code>select</code> element with its
@@ -29410,6 +29457,30 @@ function AddCloud(data, x, y) { ... }</pre>
submitted. The <code title="attr-fe-autofocus">autofocus</code>
attribute controls focus.</p>
+ <p class="XXX">...</p>
+
+ <!-- XXX
+ readonly attribute DOMString <span title="dom-select-type">type</span>;
+
+ readonly attribute <span>HTMLOptionsCollection</span> <span title="dom-select-options">options</span>;
+ attribute unsigned long <span title="dom-select-length">length</span>;
+ [IndexGetter] <span>HTMLElement</span> <span title="dom-select-XXX9">XXX9</span>(in unsigned long index);
+
+ readonly attribute <span>HTMLOptionsCollection</span> <span title="dom-select-selectedOptions">selectedOptions</span>;
+ attribute long <span title="dom-select-selectedIndex">selectedIndex</span>;
+ attribute DOMString <span title="dom-select-value">value</span>;
+
+ void <span title="dom-select-add">add</span>(in <span>HTMLElement</span> element, in <span>HTMLElement</span> before);
+ void <span title="dom-select-remove">remove</span>(in long index);
+ -->
+
+ <p>The <dfn title="dom-select-multiple"><code>multiple</code></dfn>
+ and <dfn title="dom-select-size"><code>size</code></dfn> DOM
+ attributes must <span>reflect</span> the respective content
+ attributes of the same name. The <code
+ title="dom-select-size">size</code> DOM attribute <span>limited to
+ only positive non-zero numbers</span>.</p>
+
<p>The <code title="dom-cva-willValidate">willValidate</code>, <code
title="dom-cva-validity">validity</code>, and <code
title="dom-cva-validationMessage">validationMessage</code>
@@ -29567,13 +29638,13 @@ interface <dfn>HTMLOptionElement</dfn> : <span>HTMLElement</span> {
attribute DOMString <span title="dom-textarea-defaultValue">defaultValue</span>;
attribute DOMString <span title="dom-textarea-value">value</span>;
- readonly attribute <span>NodeList</span> <span title="dom-lfe-labels">labels</span>;
-
readonly attribute boolean <span title="dom-cva-willValidate">willValidate</span>;
readonly attribute <span>ValidityState</span> <span title="dom-cva-validity">validity</span>;
readonly attribute DOMString <span title="dom-cva-validationMessage">validationMessage</span>;
boolean <span title="dom-cva-checkValidatity">checkValidity</span>();
void <span title="dom-cva-setCustomValidity">setCustomValidity</span>(in DOMString error);
+
+ readonly attribute <span>NodeList</span> <span title="dom-lfe-labels">labels</span>;
};</pre>
</dd>
</dl>

0 comments on commit c3be9ca

Please sign in to comment.