[html5] r2295 - [] (0) WF2: input.list; input.selectedOption, <datalist>; minor fixes around pre [...]

whatwg at whatwg.org whatwg at whatwg.org
Tue Oct 7 15:24:51 PDT 2008


Author: ianh
Date: 2008-10-07 15:24:50 -0700 (Tue, 07 Oct 2008)
New Revision: 2295

Modified:
   index
   source
Log:
[] (0) WF2: input.list; input.selectedOption, <datalist>; minor fixes around previous checkins

Modified: index
===================================================================
--- index	2008-10-07 21:28:39 UTC (rev 2294)
+++ index	2008-10-07 22:24:50 UTC (rev 2295)
@@ -25771,6 +25771,8 @@
 
   <p class=XXX>... <dfn id=attr-input-list title=attr-input-list><code>list</code></dfn></p>
 
+  <p class=XXX>... <dfn id=concept-input-list title=concept-input-list>suggestions
+  source element</dfn></p>
 
 
   <h6 id=the-readonly-attribute><span class=secno>4.10.4.2.3 </span>The <code title=attr-input-readonly><a href=#attr-input-readonly>readonly</a></code> attribute</h6>
@@ -26129,10 +26131,19 @@
    <li><p>Set the <a href=#concept-fe-value title=concept-fe-value>value</a> of the
    element to <var title="">value as string</var>.</li>
 
-  </ol><hr><p class=XXX>... <dfn id=dom-input-list title=dom-input-list><code>list</code></dfn></p>
-  <p class=XXX>... <dfn id=dom-input-selectedoption title=dom-input-selectedOption><code>selectedOption</code></dfn></p>
+  </ol><hr><p>The <dfn id=dom-input-list title=dom-input-list><code>list</code></dfn> DOM
+  attribute must return the current <a href=#concept-input-list title=concept-input-list>suggestions source element</a>, if
+  any, or null otherwise.</p>
 
+  <p>The <dfn id=dom-input-selectedoption title=dom-input-selectedOption><code>selectedOption</code></dfn>
+  DOM attribute must return the first <code><a href=#the-option-element>option</a></code> element, in
+  <a href=#tree-order>tree order</a>, to be a child of the <a href=#concept-input-list title=concept-input-list>suggestions source element</a> and
+  whose <a href=#concept-option-value title=concept-option-value>value</a> matches the
+  <code><a href=#the-input-element>input</a></code> element's <a href=#concept-fe-value title=concept-fe-value>value</a>, if any. If there is no <a href=#concept-input-list title=concept-input-list>suggestions source element</a>, or if
+  it contains no matching <code><a href=#the-option-element>option</a></code> element, then the <code title=dom-input-selectedOption><a href=#dom-input-selectedoption>selectedOption</a></code> attribute
+  must return null.</p>
 
+
   <h5 id=common-event-behaviors><span class=secno>4.10.4.4 </span>Common event behaviors</h5>
 
   <p>When the <dfn id=event-input-input title=event-input-input><code>input</code></dfn>
@@ -26332,7 +26343,7 @@
   void <a href=#dom-select-add title=dom-select-add>add</a>(in <a href=#htmlelement>HTMLElement</a> element, in long before);
   void <a href=#dom-select-remove title=dom-select-remove>remove</a>(in long index);
 
-  readonly attribute <a href=#htmloptionscollection-0>HTMLOptionsCollection</a> <a href=#dom-select-selectedoptions title=dom-select-selectedOptions>selectedOptions</a>;
+  readonly attribute <a href=#htmlcollection-0>HTMLCollection</a> <a href=#dom-select-selectedoptions title=dom-select-selectedOptions>selectedOptions</a>;
            attribute long <a href=#dom-select-selectedindex title=dom-select-selectedIndex>selectedIndex</a>;
            attribute DOMString <a href=#dom-select-value title=dom-select-value>value</a>;
 
@@ -26432,7 +26443,7 @@
 
   <p>The <dfn id=dom-select-length title=dom-select-length><code>length</code></dfn> DOM
   attribute, on getting and setting, must act like the <code title=dom-HTMLOptionsCollection-length><a href=#dom-htmloptionscollection-length>length</a></code> attribute on
-  the <code><a href=#htmloptionscollection-0>HTMLOptionsCollection</a></code> object return by the <code title=dom-select-options><a href=#dom-select-options>options</a></code> attribute. Similarly, the
+  the <code><a href=#htmloptionscollection-0>HTMLOptionsCollection</a></code> object returned by the <code title=dom-select-options><a href=#dom-select-options>options</a></code> attribute. Similarly, the
   <dfn id=dom-select-add title=dom-select-add><code>add()</code></dfn> and <dfn id=dom-select-remove title=dom-select-remove><code>remove()</code></dfn> methods must
   act like their namesake methods on that same
   <code><a href=#htmloptionscollection-0>HTMLOptionsCollection</a></code> object.</p>
@@ -26440,10 +26451,10 @@
   <!-- XXX9 is blocked on WebIDL -->
 
   <p>The <dfn id=dom-select-selectedoptions title=dom-select-selectedOptions><code>selectedOptions</code></dfn>
-  DOM attribute must return an <code><a href=#htmloptionscollection-0>HTMLOptionsCollection</a></code>
-  rooted at the <code><a href=#the-select-element>select</a></code> node, whose filter matches the
-  elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of
-  options</a> that have their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to
+  DOM attribute must return an <code><a href=#htmlcollection-0>HTMLCollection</a></code> rooted at
+  the <code><a href=#the-select-element>select</a></code> node, whose filter matches the elements in
+  the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>
+  that have their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to
   true.</p>
 
   <p>The <dfn id=dom-select-selectedindex title=dom-select-selectedIndex><code>selectedIndex</code></dfn>
@@ -26503,11 +26514,26 @@
    <dt>DOM interface:</dt>
    <dd>
 <pre class=idl>interface <dfn id=htmldatalistelement>HTMLDataListElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
-  readonly attribute <a href=#htmloptionscollection-0>HTMLOptionsCollection</a> <a href=#dom-select-options title=dom-select-options>options</a>;
+  readonly attribute <a href=#htmlcollection-0>HTMLCollection</a> <a href=#dom-datalist-options title=dom-datalist-options>options</a>;
 };</pre>
    </dd> 
-  </dl><p class=XXX>...</p>
+  </dl><p>The <code><a href=#the-datalist-element>datalist</a></code> element represents a set of
+  <code><a href=#the-option-element>option</a></code> elements that represent predefined options for
+  other controls. The contents of the element represents fallback
+  content for legacy user agents, intermixed with <code><a href=#the-option-element>option</a></code>
+  elements that represent the predefined options. In the rendering,
+  the <code><a href=#the-datalist-element>datalist</a></code> element represents nothing and it, along
+  with its children, should be hidden.</p>
 
+  <p>The <code><a href=#the-datalist-element>datalist</a></code> element is hooked up to an
+  <code><a href=#the-input-element>input</a></code> element using the <code title=attr-input-list><a href=#attr-input-list>list</a></code> attribute on the
+  <code><a href=#the-input-element>input</a></code> element.</p>
+
+  <p>The <dfn id=dom-datalist-options title=dom-datalist-options><code>options</code></dfn>
+  DOM attribute must return an <code><a href=#htmlcollection-0>HTMLCollection</a></code> rooted at
+  the <code><a href=#the-datalist-element>datalist</a></code> node, whose filter matches
+  <code><a href=#the-option-element>option</a></code> elements.</p>
+
   <p><strong>Constraint validation:</strong> If an element has a
   <code><a href=#the-datalist-element>datalist</a></code> element ancestor, it is <a href=#barred-from-constraint-validation>barred from
   constraint validation</a>.</p>

Modified: source
===================================================================
--- source	2008-10-07 21:28:39 UTC (rev 2294)
+++ source	2008-10-07 22:24:50 UTC (rev 2295)
@@ -28739,6 +28739,8 @@
 
   <p class="XXX">... <dfn title="attr-input-list"><code>list</code></dfn></p>
 
+  <p class="XXX">... <dfn title="concept-input-list">suggestions
+  source element</dfn></p>
 
 
   <h6>The <code title="attr-input-readonly">readonly</code> attribute</h6>
@@ -29217,10 +29219,25 @@
 
   <hr>
 
-  <p class="XXX">... <dfn title="dom-input-list"><code>list</code></dfn></p>
-  <p class="XXX">... <dfn title="dom-input-selectedOption"><code>selectedOption</code></dfn></p>
+  <p>The <dfn title="dom-input-list"><code>list</code></dfn> DOM
+  attribute must return the current <span
+  title="concept-input-list">suggestions source element</span>, if
+  any, or null otherwise.</p>
 
+  <p>The <dfn
+  title="dom-input-selectedOption"><code>selectedOption</code></dfn>
+  DOM attribute must return the first <code>option</code> element, in
+  <span>tree order</span>, to be a child of the <span
+  title="concept-input-list">suggestions source element</span> and
+  whose <span title="concept-option-value">value</span> matches the
+  <code>input</code> element's <span
+  title="concept-fe-value">value</span>, if any. If there is no <span
+  title="concept-input-list">suggestions source element</span>, or if
+  it contains no matching <code>option</code> element, then the <code
+  title="dom-input-selectedOption">selectedOption</code> attribute
+  must return null.</p>
 
+
   <h5>Common event behaviors</h5>
 
   <p>When the <dfn title="event-input-input"><code>input</code></dfn>
@@ -29459,7 +29476,7 @@
   void <span title="dom-select-add">add</span>(in <span>HTMLElement</span> element, in long before);
   void <span title="dom-select-remove">remove</span>(in long index);
 
-  readonly attribute <span>HTMLOptionsCollection</span> <span title="dom-select-selectedOptions">selectedOptions</span>;
+  readonly attribute <span>HTMLCollection</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>;
 
@@ -29581,7 +29598,7 @@
   <p>The <dfn title="dom-select-length"><code>length</code></dfn> DOM
   attribute, on getting and setting, must act like the <code
   title="dom-HTMLOptionsCollection-length">length</code> attribute on
-  the <code>HTMLOptionsCollection</code> object return by the <code
+  the <code>HTMLOptionsCollection</code> object returned by the <code
   title="dom-select-options">options</code> attribute. Similarly, the
   <dfn title="dom-select-add"><code>add()</code></dfn> and <dfn
   title="dom-select-remove"><code>remove()</code></dfn> methods must
@@ -29592,10 +29609,10 @@
 
   <p>The <dfn
   title="dom-select-selectedOptions"><code>selectedOptions</code></dfn>
-  DOM attribute must return an <code>HTMLOptionsCollection</code>
-  rooted at the <code>select</code> node, whose filter matches the
-  elements in the <span title="concept-select-option-list">list of
-  options</span> that have their <span
+  DOM attribute must return an <code>HTMLCollection</code> rooted at
+  the <code>select</code> node, whose filter matches the elements in
+  the <span title="concept-select-option-list">list of options</span>
+  that have their <span
   title="concept-option-selectedness">selectedness</span> set to
   true.</p>
 
@@ -29679,13 +29696,29 @@
    <dt>DOM interface:</dt>
    <dd>
 <pre class="idl">interface <dfn>HTMLDataListElement</dfn> : <span>HTMLElement</span> {
-  readonly attribute <span>HTMLOptionsCollection</span> <span title="dom-select-options">options</span>;
+  readonly attribute <span>HTMLCollection</span> <span title="dom-datalist-options">options</span>;
 };</pre>
    </dd> 
   </dl>
 
-  <p class="XXX">...</p>
+  <p>The <code>datalist</code> element represents a set of
+  <code>option</code> elements that represent predefined options for
+  other controls. The contents of the element represents fallback
+  content for legacy user agents, intermixed with <code>option</code>
+  elements that represent the predefined options. In the rendering,
+  the <code>datalist</code> element represents nothing and it, along
+  with its children, should be hidden.</p>
 
+  <p>The <code>datalist</code> element is hooked up to an
+  <code>input</code> element using the <code
+  title="attr-input-list">list</code> attribute on the
+  <code>input</code> element.</p>
+
+  <p>The <dfn title="dom-datalist-options"><code>options</code></dfn>
+  DOM attribute must return an <code>HTMLCollection</code> rooted at
+  the <code>datalist</code> node, whose filter matches
+  <code>option</code> elements.</p>
+
   <p><strong>Constraint validation:</strong> If an element has a
   <code>datalist</code> element ancestor, it is <span>barred from
   constraint validation</span>.</p>




More information about the Commit-Watchers mailing list