W3C home > Mailing lists > Public > public-html-commits@w3.org > October 2008

html5/spec Overview.html,1.1457,1.1458

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Mon, 06 Oct 2008 10:16:40 +0000
To: public-html-commits@w3.org
Message-Id: <E1Kmn8q-0001Ay-BI@lionel-hutz.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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 9 October 2008 20:33:00 GMT