- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 06 Oct 2008 10:16:40 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv4498
Modified Files:
Overview.html
Log Message:
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. (whatwg r2285)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1457
retrieving revision 1.1458
diff -u -d -r1.1457 -r1.1458
--- Overview.html 5 Oct 2008 09:27:31 -0000 1.1457
+++ Overview.html 6 Oct 2008 10:16:37 -0000 1.1458
@@ -8,7 +8,7 @@
<p><a href=http://www.w3.org/><img alt=W3C height=48 src=http://www.w3.org/Icons/w3c_home width=72></a></p>
<h1>HTML 5</h1>
<h2 class="no-num no-toc" id=a-vocabulary-and-associated-apis-for-html-and-xhtml>A vocabulary and associated APIs for HTML and XHTML</h2>
- <h2 class="no-num no-toc" id=editor-s-draft-date-zzz-9-june-2008><!-- "W3C Working Draft" --> Editor's Draft <!--ZZZ-->5 October 2008</h2>
+ <h2 class="no-num no-toc" id=editor-s-draft-date-zzz-9-june-2008><!-- "W3C Working Draft" --> Editor's Draft <!--ZZZ-->6 October 2008</h2>
<dl><!-- ZZZ: update the month/day
<dt>This Version:</dt>
<dd><a href="http://www.w3.org/TR/2008/WD-html5-20080609/">http://www.w3.org/TR/2008/WD-html5-20080609/</a></dd>
@@ -100,7 +100,7 @@
specification's progress along the W3C Recommendation
track.
<!--ZZZ:-->
- This specification is the 5 October 2008 <!--ZZZ "Working Draft"-->Editor's Draft.
+ This specification is the 6 October 2008 <!--ZZZ "Working Draft"-->Editor's Draft.
<!--:ZZZ-->
</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is also being produced by the <a href=http://www.whatwg.org/>WHATWG</a>. The two specifications are
identical from the table of contents onwards.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to replace (be a new version of)
@@ -14097,9 +14097,7 @@
the <code title=attr-media-loopStart><a href=#attr-media-loopstart>loopstart</a></code> content
attribute is the value of the <code title=dom-media-start><a href=#dom-media-start>start</a></code> DOM attribute.<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>
-
- <p>The <dfn id=attr-media-loopend title=attr-media-loopend><code>loopend</code></dfn>
+ and the end of the <a href=#media-resource>media resource</a>.<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
resource</a> at which playback is to jump back to the <code title=attr-media-loopstart><a href=#attr-media-loopstart>loopstart</a></code>, when looping the
clip. The default value of the <code title=attr-media-loopEnd><a href=#attr-media-loopend>loopend</a></code> content attribute is the
@@ -14107,16 +14105,12 @@
attribute.<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>
-
- <p>The <dfn id=attr-media-end title=attr-media-end><code>end</code></dfn> content
+ which case that's its value.<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
which playback is to end. The default value is infinity.<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>
-
- <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,
+ case that's its value.<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
offsets</span>. To get the time values they represent, user agents
must use the <a href=#rules-for-parsing-time-offsets>rules for parsing time offsets</a>.<p>The <dfn id=dom-media-start title=dom-media-start><code>start</code></dfn>, <dfn id=dom-media-loopstart title=dom-media-loopStart><code>loopStart</code></dfn>, <dfn id=dom-media-loopend title=dom-media-loopEnd><code>loopEnd</code></dfn>, and <dfn id=dom-media-end title=dom-media-end><code>end</code></dfn> DOM attributes must
@@ -18629,8 +18623,6 @@
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);
@@ -18639,6 +18631,8 @@
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,
@@ -20710,10 +20704,15 @@
element is <i title=concept-input-immutable><a href=#concept-input-immutable>immutable</a></i>.<p><strong>Constraint validation:</strong> If the <code title=attr-input-readonly><a href=#attr-input-readonly>readonly</a></code> attribute is specified
on an <code><a href=#the-input-element>input</a></code> element, the element is <a href=#barred-from-constraint-validation>barred from
constraint validation</a>.<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>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>The <code title=dom-input-size><a href=#dom-input-size>size</a></code> DOM attribute
+ 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>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>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 class=XXX>The rendering section will define this in more
+ detail.<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>.<h6 id=the-required-attribute><span class=secno>4.10.4.2.5 </span>The <code title=attr-input-required><a href=#attr-input-required>required</a></code> attribute</h6><p>The <dfn id=attr-input-required title=attr-input-required><code>required</code></dfn>
attribute is a <a href=#boolean-attribute>boolean attribute</a>. When specified, the
element is <dfn id=concept-input-required title=concept-input-required><i>required</i></dfn>.<p><strong>Constraint validation:</strong> If the element is <i title=concept-input-required><a href=#concept-input-required>required</a></i>, and its <code title=dom-input-value><a href=#dom-input-value>value</a></code> DOM attribute applies and is in
@@ -20998,13 +20997,13 @@
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
@@ -21079,18 +21078,18 @@
<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>;
@@ -21102,8 +21101,6 @@
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);
@@ -21112,15 +21109,60 @@
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>The <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute is used to
+ </dl><p>The <code><a href=#the-select-element>select</a></code> element represents a control for
+ selecting amongst a set of options.<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>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>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
<a href=#form-owner>form owner</a>. The <code title=attr-fe-name><a href=#attr-fe-name>name</a></code>
attribute represents the element's name. The <code title=attr-fe-disabled><a href=#attr-fe-disabled>disabled</a></code> attribute is used to make
the control non-interactive and to prevent its value from being
submitted. The <code title=attr-fe-autofocus><a href=#attr-fe-autofocus>autofocus</a></code>
- attribute controls focus.<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>
+ attribute controls focus.<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>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
<code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> element provides a list
@@ -21234,13 +21276,13 @@
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>The <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute is used to
@@ -22779,7 +22821,7 @@
<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>
@@ -24090,7 +24132,7 @@
empty string <a href=#concept-command title=concept-command>defines a
command</a>.<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>The <a href=#command-facet-id title=command-facet-ID>ID</a> of the command is
the value of the <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute of the
element, if the attribute is present and not empty. Otherwise the
Received on Monday, 6 October 2008 10:17:14 UTC