[e] (0) Try to clarify that a control's 'value' isn't what the user h…

…as entered, necessarily. Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=25369 Affected topics: HTML git-svn-id: http://svn.whatwg.org/webapps@8703 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Aug 4, 2014 · fd90b03 · fd90b03
1 parent 04e646f
commit fd90b03
Show file tree

Hide file tree

Showing 3 changed files with 27 additions and 2 deletions.
diff --git a/complete.html b/complete.html
@@ -39182,11 +39182,18 @@ <h5 id="a-form-control's-value">4.10.18.1 A form control's value</h5>
   <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 @@ <h2 id=acknowledgements class=no-num>Acknowledgements</h2>
   Martin Thomson,
   Masataka Yakura,
   Masatoshi Kimura,
+  Mason Mize,
   Mathias Bynens,
   Mathieu Henri,
   Matias Larsson,

diff --git a/index b/index
@@ -39182,11 +39182,18 @@ out of 233 257 824 bytes available&lt;/meter>&lt;/p></pre>
   <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 @@ if (s = prompt('What is your name?')) {
   Martin Thomson,
   Masataka Yakura,
   Masatoshi Kimura,
+  Mason Mize,
   Mathias Bynens,
   Mathieu Henri,
   Matias Larsson,

diff --git a/source b/source
@@ -50582,6 +50582,14 @@ out of 233&#x2009;257&#x2009;824 bytes available&lt;/meter>&lt;/p></pre>
   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 @@ INSERT INTERFACES HERE
   Martin Thomson,
   Masataka Yakura,
   Masatoshi Kimura,
+  Mason Mize,
   Mathias Bynens,
   Mathieu Henri,
   Matias Larsson,