[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