[html5] r2292 - [] (0) WF2: <select> interaction.

[whatwg at whatwg.org]

Author: ianh
Date: 2008-10-07 14:06:35 -0700 (Tue, 07 Oct 2008)
New Revision: 2292

Modified:
   index
   source
Log:
[] (0) WF2: <select> interaction.

Modified: index
===================================================================
--- index	2008-10-07 05:22:53 UTC (rev 2291)
+++ index	2008-10-07 21:06:35 UTC (rev 2292)
@@ -26380,6 +26380,36 @@
   rendered as a list select box.</p>
   -->
 
+  <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
+  attribute is absent, and the element is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, then the user agent
+  should allow the user to pick an <code><a href=#the-option-element>option</a></code> element in its
+  <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> that
+  is itself not <a href=#concept-option-disabled title=concept-option-disabled>disabled</a>. Upon this
+  <code><a href=#the-option-element>option</a></code> element being picked (either through a click, or
+  through unfocusing the element after changing its value, or through
+  any other mechanism), and before the relevant user interaction event
+  is queued (e.g. before the <span title=event-click>click</span>
+  event), the user agent must set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the
+  picked <code><a href=#the-option-element>option</a></code> element to true, set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of all the
+  other <code><a href=#the-option-element>option</a></code> element in its <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> to false,
+  and then <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple
+  event</a> called <code title=event-change>change</code> at the
+  <code><a href=#the-select-element>select</a></code> element, using the <a href=#user-interaction-task-source>user interaction task
+  source</a> as the task source.</p>
+
+  <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
+  attribute is present, and the element is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, then the user agent
+  should allow the user to toggle the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the
+  <code><a href=#the-option-element>option</a></code> elements in its <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> that are
+  themselves not <a href=#concept-option-disabled title=concept-option-disabled>disabled</a>. Upon the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of one or
+  more <code><a href=#the-option-element>option</a></code> elements being changed by the user, and
+  before the relevant user interaction event is queued (e.g. before a
+  related <span title=event-click>click</span> event), the user
+  agent must <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple
+  event</a> called <code title=event-change>change</code> at the
+  <code><a href=#the-select-element>select</a></code> element, using the <a href=#user-interaction-task-source>user interaction task
+  source</a> as the task source.</p>
+
   <p>The <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute is used to
   explicitly associate the <code><a href=#the-select-element>select</a></code> element with its
   <a href=#form-owner>form owner</a>. The <code title=attr-fe-name><a href=#attr-fe-name>name</a></code>
@@ -26509,10 +26539,12 @@
    </dd> 
   </dl><p class=XXX>...</p>
 
-  <p class=XXX>... <dfn id=concept-option-selected title=concept-option-selected>selected</dfn></p>
+  <p class=XXX>... <dfn id=concept-option-selected title=concept-option-selected>selected</dfn>/<dfn id=concept-option-selectedness title=concept-option-selectedness>selectedness</dfn></p>
 
   <p class=XXX>... <dfn id=concept-option-value title=concept-option-value>value</dfn></p>
 
+  <p class=XXX>... <dfn id=concept-option-disabled title=concept-option-disabled>disabled</dfn></p>
+
   <p class=XXX>
    <dfn id=dom-option title=dom-option><code>Option()</code></dfn>
    <dfn id=dom-option-n title=dom-option-n><code>Option(<var title="">name</var>)</code></dfn>

Modified: source
===================================================================
--- source	2008-10-07 05:22:53 UTC (rev 2291)
+++ source	2008-10-07 21:06:35 UTC (rev 2292)
@@ -29515,6 +29515,46 @@
   rendered as a list select box.</p>
   -->
 
+  <p>If the <code title="attr-select-multiple">multiple</code>
+  attribute is absent, and the element is not <span
+  title="concept-fe-disabled">disabled</span>, then the user agent
+  should allow the user to pick an <code>option</code> element in its
+  <span title="concept-select-option-list">list of options</span> that
+  is itself not <span
+  title="concept-option-disabled">disabled</span>. Upon this
+  <code>option</code> element being picked (either through a click, or
+  through unfocusing the element after changing its value, or through
+  any other mechanism), and before the relevant user interaction event
+  is queued (e.g. before the <span title="event-click">click</span>
+  event), the user agent must set the <span
+  title="concept-option-selectedness">selectedness</span> of the
+  picked <code>option</code> element to true, set the <span
+  title="concept-option-selectedness">selectedness</span> of all the
+  other <code>option</code> element in its <span
+  title="concept-select-option-list">list of options</span> to false,
+  and then <span>queue a task</span> to <span>fire a simple
+  event</span> called <code title="event-change">change</code> at the
+  <code>select</code> element, using the <span>user interaction task
+  source</span> as the task source.</p>
+
+  <p>If the <code title="attr-select-multiple">multiple</code>
+  attribute is present, and the element is not <span
+  title="concept-fe-disabled">disabled</span>, then the user agent
+  should allow the user to toggle the <span
+  title="concept-option-selectedness">selectedness</span> of the
+  <code>option</code> elements in its <span
+  title="concept-select-option-list">list of options</span> that are
+  themselves not <span
+  title="concept-option-disabled">disabled</span>. Upon the <span
+  title="concept-option-selectedness">selectedness</span> of one or
+  more <code>option</code> elements being changed by the user, and
+  before the relevant user interaction event is queued (e.g. before a
+  related <span title="event-click">click</span> event), the user
+  agent must <span>queue a task</span> to <span>fire a simple
+  event</span> called <code title="event-change">change</code> at the
+  <code>select</code> element, using the <span>user interaction task
+  source</span> as the task source.</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>
@@ -29665,10 +29705,12 @@
 
   <p class="XXX">...</p>
 
-  <p class="XXX">... <dfn title="concept-option-selected">selected</dfn></p>
+  <p class="XXX">... <dfn title="concept-option-selected">selected</dfn>/<dfn title="concept-option-selectedness">selectedness</dfn></p>
 
   <p class="XXX">... <dfn title="concept-option-value">value</dfn></p>
 
+  <p class="XXX">... <dfn title="concept-option-disabled">disabled</dfn></p>
+
   <p class="XXX">
    <dfn title="dom-option"><code>Option()</code></dfn>
    <dfn title="dom-option-n"><code>Option(<var title="">name</var>)</code></dfn>