HTML Standard Tracker

Diff (omit for latest revision)
Filter

Short URL: http://html5.org/r/2285

File a bug

SVNBugCommentTime (UTC)
2285WF2: <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.2008-10-06 10:16
Index: source
===================================================================
--- source	(revision 2284)
+++ source	(revision 2285)
@@ -18495,7 +18495,7 @@
 
   <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 @@
   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 @@
   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 @@
            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 @@
   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,14 +28690,22 @@
   <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 @@
            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 @@
            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,12 +29401,53 @@
   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
   <span>form owner</span>. The <code title="attr-fe-name">name</code>
@@ -29410,6 +29457,30 @@
   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 @@
            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>

|