[html5] r2296 - [] (0) WF2: <input list=''>
whatwg at whatwg.org
whatwg at whatwg.org
Tue Oct 7 15:52:38 PDT 2008
Author: ianh
Date: 2008-10-07 15:52:37 -0700 (Tue, 07 Oct 2008)
New Revision: 2296
Modified:
index
source
Log:
[] (0) WF2: <input list=''>
Modified: index
===================================================================
--- index 2008-10-07 22:24:50 UTC (rev 2295)
+++ index 2008-10-07 22:52:37 UTC (rev 2296)
@@ -25769,12 +25769,45 @@
<h6 id=the-list-attribute><span class=secno>4.10.4.2.2 </span>The <code title=attr-input-list><a href=#attr-input-list>list</a></code> attribute</h6>
- <p class=XXX>... <dfn id=attr-input-list title=attr-input-list><code>list</code></dfn></p>
+ <p>The <dfn id=attr-input-list title=attr-input-list><code>list</code></dfn>
+ attribute is used to identify an element that lists predefined
+ options suggested to the user.</p>
- <p class=XXX>... <dfn id=concept-input-list title=concept-input-list>suggestions
- source element</dfn></p>
+ <p>The <dfn id=concept-input-list title=concept-input-list>suggestions source
+ element</dfn> is the first element in the document in <a href=#tree-order>tree
+ order</a> to have an ID equal to the value of the <code title=attr-input-list><a href=#attr-input-list>list</a></code> attribute, if that element is
+ either a <code><a href=#the-select-element>select</a></code> or <code><a href=#the-datalist-element>datalist</a></code> element. If
+ there is no <code title=attr-input-list><a href=#attr-input-list>list</a></code> attribute, or
+ if there is no element with that ID, or if the first element with
+ that ID is not either a <code><a href=#the-select-element>select</a></code> or <code><a href=#the-datalist-element>datalist</a></code>
+ element, then there is no <a href=#concept-input-list title=concept-input-list>suggestions source element</a>.</p>
+ <p>If there is a <a href=#concept-input-list title=concept-input-list>suggestions source
+ element</a>, then each <code><a href=#the-option-element>option</a></code> element that is a
+ descendant of the <a href=#concept-input-list title=concept-input-list>suggestions
+ source element</a>, that is not <a href=#concept-option-disabled title=concept-option-disabled>disabled</a>, and whose <a href=#concept-option-value title=concept-option-value>value</a> is a string that isn't the
+ empty string and that the user would be allowed to enter as the
+ <code><a href=#the-input-element>input</a></code> element's <a href=#concept-fe-value title=concept-fe-value>value</a>, represents a suggestion. Each
+ suggestion has a <a href=#concept-option-value title=concept-option-value>value</a> and
+ a <a href=#concept-option-label title=concept-option-label>label</a>.</p>
+ <p>When the user agent is allowing the user to edit the
+ <code><a href=#the-input-element>input</a></code> element's <a href=#concept-fe-value title=concept-fe-value>value</a>, the user agent should offer
+ the suggestions to the user in a manner suitable for the type of
+ control used. The user agent may use the suggestion's <a href=#concept-option-label title=concept-option-label>label</a> to identify the suggestion
+ if appropriate. If the user selects a suggestion, then the
+ <code><a href=#the-input-element>input</a></code> element's <a href=#concept-fe-value title=concept-fe-value>value</a> must be set to the selected
+ suggestion's <a href=#concept-option-value title=concept-option-value>value</a>, as if
+ the user had written that value himself.</p>
+
+ <p>User agents should filter the suggestions to hide suggestions
+ that would cause the element to not <a href=#concept-fv-valid title=concept-fv-valid>satisfy its constraints</a>.</p>
+
+ <hr><p>If the <code title=attr-input-list><a href=#attr-input-list>list</a></code> attribute does
+ not apply, there is no <a href=#concept-input-list title=concept-input-list>suggestions
+ source element</a>.</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>
<p>The <dfn id=attr-input-readonly title=attr-input-readonly><code>readonly</code></dfn>
@@ -26598,6 +26631,8 @@
<p class=XXX>... <dfn id=concept-option-value title=concept-option-value>value</dfn></p>
+ <p class=XXX>... <dfn id=concept-option-label title=concept-option-label>label</dfn></p>
+
<p class=XXX>... <dfn id=concept-option-disabled title=concept-option-disabled>disabled</dfn></p>
<p class=XXX>... <dfn id=concept-option-index title=concept-option-index>index</dfn></p>
Modified: source
===================================================================
--- source 2008-10-07 22:24:50 UTC (rev 2295)
+++ source 2008-10-07 22:52:37 UTC (rev 2296)
@@ -28737,12 +28737,56 @@
<h6>The <code title="attr-input-list">list</code> attribute</h6>
- <p class="XXX">... <dfn title="attr-input-list"><code>list</code></dfn></p>
+ <p>The <dfn title="attr-input-list"><code>list</code></dfn>
+ attribute is used to identify an element that lists predefined
+ options suggested to the user.</p>
- <p class="XXX">... <dfn title="concept-input-list">suggestions
- source element</dfn></p>
+ <p>The <dfn title="concept-input-list">suggestions source
+ element</dfn> is the first element in the document in <span>tree
+ order</span> to have an ID equal to the value of the <code
+ title="attr-input-list">list</code> attribute, if that element is
+ either a <code>select</code> or <code>datalist</code> element. If
+ there is no <code title="attr-input-list">list</code> attribute, or
+ if there is no element with that ID, or if the first element with
+ that ID is not either a <code>select</code> or <code>datalist</code>
+ element, then there is no <span
+ title="concept-input-list">suggestions source element</span>.</p>
+ <p>If there is a <span title="concept-input-list">suggestions source
+ element</span>, then each <code>option</code> element that is a
+ descendant of the <span title="concept-input-list">suggestions
+ source element</span>, that is not <span
+ title="concept-option-disabled">disabled</span>, and whose <span
+ title="concept-option-value">value</span> is a string that isn't the
+ empty string and that the user would be allowed to enter as the
+ <code>input</code> element's <span
+ title="concept-fe-value">value</span>, represents a suggestion. Each
+ suggestion has a <span title="concept-option-value">value</span> and
+ a <span title="concept-option-label">label</span>.</p>
+ <p>When the user agent is allowing the user to edit the
+ <code>input</code> element's <span
+ title="concept-fe-value">value</span>, the user agent should offer
+ the suggestions to the user in a manner suitable for the type of
+ control used. The user agent may use the suggestion's <span
+ title="concept-option-label">label</span> to identify the suggestion
+ if appropriate. If the user selects a suggestion, then the
+ <code>input</code> element's <span
+ title="concept-fe-value">value</span> must be set to the selected
+ suggestion's <span title="concept-option-value">value</span>, as if
+ the user had written that value himself.</p>
+
+ <p>User agents should filter the suggestions to hide suggestions
+ that would cause the element to not <span
+ title="concept-fv-valid">satisfy its constraints</span>.</p>
+
+ <hr>
+
+ <p>If the <code title="attr-input-list">list</code> attribute does
+ not apply, there is no <span title="concept-input-list">suggestions
+ source element</span>.</p>
+
+
<h6>The <code title="attr-input-readonly">readonly</code> attribute</h6>
<p>The <dfn title="attr-input-readonly"><code>readonly</code></dfn>
@@ -29789,6 +29833,8 @@
<p class="XXX">... <dfn title="concept-option-value">value</dfn></p>
+ <p class="XXX">... <dfn title="concept-option-label">label</dfn></p>
+
<p class="XXX">... <dfn title="concept-option-disabled">disabled</dfn></p>
<p class="XXX">... <dfn title="concept-option-index">index</dfn></p>
More information about the Commit-Watchers
mailing list