[html5] r8703 - [e] (0) Try to clarify that a control's 'value' isn't what the user has entered, [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2014-08-04 15:05:49 -0700 (Mon, 04 Aug 2014)
New Revision: 8703

Modified:
   complete.html
   index
   source
Log:
[e] (0) Try to clarify that a control's 'value' isn't what the user has entered, necessarily.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=25369
Affected topics: HTML

Modified: complete.html
===================================================================
--- complete.html	2014-08-04 21:21:11 UTC (rev 8702)
+++ complete.html	2014-08-04 22:05:49 UTC (rev 8703)
@@ -39182,11 +39182,18 @@
   <p>Most form controls have a <dfn id=concept-fe-value>value</dfn> and a <dfn id=concept-fe-checked>checkedness</dfn>. (The latter is only used by <code id="a-form-control's-value:the-input-element"><a href=#the-input-element>input</a></code>
   elements.) These are used to describe how the user interacts with the control.</p>
 
+  <p>A control's <a href=#concept-fe-value id="a-form-control's-value:concept-fe-value">value</a> is its internal state. As such, it
+  might not match the user's current input.</p>
+
+  <p class=example>For instance, if a user enters the word "<kbd>three</kbd>" into <a href="#number-state-(type=number)" id="a-form-control's-value:number-state-(type=number)">a numeric field</a> that expects digits, the user's input would
+  be the string "three" but the control's <a href=#concept-fe-value id="a-form-control's-value:concept-fe-value-2">value</a> would remain
+  unchanged.</p>
+
   <p>To define the behaviour of constraint validation in the face of the <code id="a-form-control's-value:the-input-element-2"><a href=#the-input-element>input</a></code>
   element's <code id="a-form-control's-value:attr-input-multiple"><a href=#attr-input-multiple>multiple</a></code> attribute, <code id="a-form-control's-value:the-input-element-3"><a href=#the-input-element>input</a></code> elements
   can also have separately defined <dfn id=concept-fe-values>value<em>s</em></dfn>.</p>
 
-  <p>The <code id="a-form-control's-value:the-select-element"><a href=#the-select-element>select</a></code> element does not have a <a href=#concept-fe-value id="a-form-control's-value:concept-fe-value">value</a>;
+  <p>The <code id="a-form-control's-value:the-select-element"><a href=#the-select-element>select</a></code> element does not have a <a href=#concept-fe-value id="a-form-control's-value:concept-fe-value-3">value</a>;
   the <a href=#concept-option-selectedness id="a-form-control's-value:concept-option-selectedness">selectedness</a> of its <code id="a-form-control's-value:the-option-element"><a href=#the-option-element>option</a></code>
   elements is what is used instead.</p>
 
@@ -84033,6 +84040,7 @@
   Martin Thomson,
   Masataka Yakura,
   Masatoshi Kimura,
+  Mason Mize,
   Mathias Bynens,
   Mathieu Henri,
   Matias Larsson,

Modified: index
===================================================================
--- index	2014-08-04 21:21:11 UTC (rev 8702)
+++ index	2014-08-04 22:05:49 UTC (rev 8703)
@@ -39182,11 +39182,18 @@
   <p>Most form controls have a <dfn id=concept-fe-value>value</dfn> and a <dfn id=concept-fe-checked>checkedness</dfn>. (The latter is only used by <code id="a-form-control's-value:the-input-element"><a href=#the-input-element>input</a></code>
   elements.) These are used to describe how the user interacts with the control.</p>
 
+  <p>A control's <a href=#concept-fe-value id="a-form-control's-value:concept-fe-value">value</a> is its internal state. As such, it
+  might not match the user's current input.</p>
+
+  <p class=example>For instance, if a user enters the word "<kbd>three</kbd>" into <a href="#number-state-(type=number)" id="a-form-control's-value:number-state-(type=number)">a numeric field</a> that expects digits, the user's input would
+  be the string "three" but the control's <a href=#concept-fe-value id="a-form-control's-value:concept-fe-value-2">value</a> would remain
+  unchanged.</p>
+
   <p>To define the behaviour of constraint validation in the face of the <code id="a-form-control's-value:the-input-element-2"><a href=#the-input-element>input</a></code>
   element's <code id="a-form-control's-value:attr-input-multiple"><a href=#attr-input-multiple>multiple</a></code> attribute, <code id="a-form-control's-value:the-input-element-3"><a href=#the-input-element>input</a></code> elements
   can also have separately defined <dfn id=concept-fe-values>value<em>s</em></dfn>.</p>
 
-  <p>The <code id="a-form-control's-value:the-select-element"><a href=#the-select-element>select</a></code> element does not have a <a href=#concept-fe-value id="a-form-control's-value:concept-fe-value">value</a>;
+  <p>The <code id="a-form-control's-value:the-select-element"><a href=#the-select-element>select</a></code> element does not have a <a href=#concept-fe-value id="a-form-control's-value:concept-fe-value-3">value</a>;
   the <a href=#concept-option-selectedness id="a-form-control's-value:concept-option-selectedness">selectedness</a> of its <code id="a-form-control's-value:the-option-element"><a href=#the-option-element>option</a></code>
   elements is what is used instead.</p>
 
@@ -84033,6 +84040,7 @@
   Martin Thomson,
   Masataka Yakura,
   Masatoshi Kimura,
+  Mason Mize,
   Mathias Bynens,
   Mathieu Henri,
   Matias Larsson,

Modified: source
===================================================================
--- source	2014-08-04 21:21:11 UTC (rev 8702)
+++ source	2014-08-04 22:05:49 UTC (rev 8703)
@@ -50582,6 +50582,14 @@
   data-x="concept-fe-checked">checkedness</dfn>. (The latter is only used by <code>input</code>
   elements.) These are used to describe how the user interacts with the control.</p>
 
+  <p>A control's <span data-x="concept-fe-value">value</span> is its internal state. As such, it
+  might not match the user's current input.</p>
+
+  <p class="example">For instance, if a user enters the word "<kbd>three</kbd>" into <span
+  data-x="attr-input-type-number">a numeric field</span> that expects digits, the user's input would
+  be the string "three" but the control's <span data-x="concept-fe-value">value</span> would remain
+  unchanged.</p>
+
   <p>To define the behaviour of constraint validation in the face of the <code>input</code>
   element's <code data-x="attr-input-multiple">multiple</code> attribute, <code>input</code> elements
   can also have separately defined <dfn data-x="concept-fe-values">value<em>s</em></dfn>.</p>
@@ -115491,6 +115499,7 @@
   Martin Thomson,
   Masataka Yakura,
   Masatoshi Kimura,
+  Mason Mize,
   Mathias Bynens,
   Mathieu Henri,
   Matias Larsson,