[] (0) WF2: <input list=''>

git-svn-id: http://svn.whatwg.org/webapps@2296 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Oct 7, 2008 · 2e039a1 · 2e039a1
1 parent 1a0c484
commit 2e039a1
Show file tree

Hide file tree

Showing 2 changed files with 88 additions and 7 deletions.
diff --git a/index b/index
@@ -25769,10 +25769,43 @@ function AddCloud(data, x, y) { ... }</pre>
 
   <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 class=XXX>... <dfn id=concept-input-list title=concept-input-list>suggestions
-  source element</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>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>
@@ -26598,6 +26631,8 @@ interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href=#htmleleme
 
   <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>

diff --git a/source b/source
@@ -28737,10 +28737,54 @@ function AddCloud(data, x, y) { ... }</pre>
 
   <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>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 class="XXX">... <dfn title="concept-input-list">suggestions
-  source element</dfn></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>
@@ -29789,6 +29833,8 @@ interface <dfn>HTMLOptionElement</dfn> : <span>HTMLElement</span> {
 
   <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>