spec/Overview.html 1.1386 2213 WF2: Define input.value, especially for

WF2: Define input.value, especially for type=text; and related tweaks to
make things read better. (whatwg r2213)

4.9.14 Attributes for form submission
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#attributes2
disabled
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#disabled6
value
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#value11
dirty
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#dirty0
value setter algorithm
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#value10
4.9.4.2. Common input element attributes
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#common4
4.9.4.3. Common input element APIs
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#common5
4.9.4.1.21. Common algorithms
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#common3
4.9.4.3.1. Value manipulation
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#value
control initialization algorithm
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#control0
selected
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#selected1
Constructing the form data set. For each element field in controls, in tree order, run the following substeps: If any of the following conditions are met, then skip these substeps for this element: The field element has a datalist element ancestor. The field element is disabled. The field element is a button but it is not submitter. The field element is an input element whose type attribute is in the Checkbox state and the control is not checked. The field element is an input element whose type attribute is in the Radio Button state and the control is not checked. The field element is an input element whose type attribute is in the File Upload state but the control does not have any files selected. Otherwise, process field as follows: If the field element is an input element whose type attribute is in the Image Button state, then run these further nested substeps: If the field element has an name attribute specified and value is not the empty string, let name be that value followed by a single U+002E FULL SOP (.) character. Otherwise, let name be the empty string. Let namex be the string consisting of the concatenation of name and a single U+0078 LATIN SMALL LETTER X (x) character. Let namey be the string consisting of the concatenation of name and a single U+0079 LATIN SMALL LETTER Y (y) character. The field element is submitter, and before this algorithm was invoked the user indicated a coordinate. Let x be the x-component of the coordindate selected by the user, and let y be the y-component of the coordinate selected by the user. Append an entry in the form data set with the name namex and the value x. Append an entry in the form data set with the name namey and the value y. Skip the remaining substeps for this element: if there are any more elements in controls, return to the top of the constructing the form data set step, otherwise, jump to the next step in the overall form submission algorithm. If the field element does not have a name attribute specified, or its name attribute's value is the empty strig, skip these substeps for this element: if there are any more elements in controls, return to the top of the constructing the form data set step, otherwise, jump to the next step in the overall form submission algorithm. Let name be the value of the field element's name attribute. If the field element is a select element, then for each option element in the select element that is selected, append an entry in the form data set with the name as the name and the value of the option element as the value. Otherwise, if the field element is an input element whose type attribute is in the File Upload state, then for each file selected in the input element, append an entry in the form data set with the name as the name and the file as the value. (Both the file name and the file contents are subsequently used.) Otherwise, append an entry in the form data set with name as the name and the value of the field element as the value.
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#constructing-form-data-set
Option()
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#option0
strip line breaks from the value
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#strip
value
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#value12
4.9.4.1.1. Text state
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#text-state
immutable
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#immutable
value
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#value9
value
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1386.html#value8

http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.1385&r2=1.1386&f=h
http://html5.org/tools/web-apps-tracker?from=2212&to=2213

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1385
retrieving revision 1.1386
diff -u -d -r1.1385 -r1.1386
--- Overview.html 18 Sep 2008 00:42:11 -0000 1.1385
+++ Overview.html 18 Sep 2008 03:18:20 -0000 1.1386
@@ -28613,7 +28613,7 @@
    state must be invoked.
 
   <p>Each <code><a href="#input0">input</a></code> element has a <a
-   href="#value11" title=concept-fe-value>value</a>, which is exposed by the
+   href="#value12" title=concept-fe-value>value</a>, which is exposed by the
    <code title=dom-input-value><a href="#value9">value</a></code> DOM
    attribute.
 
@@ -28624,7 +28624,11 @@
    element is <dfn id=immutable
    title=concept-input-immutable><i>immutable</i></dfn>. Unless otherwise
    specified, an <code><a href="#input0">input</a></code> element is always
-   <i title=concept-input-mutable><a href="#mutable">mutable</a></i>.
+   <i title=concept-input-mutable><a href="#mutable">mutable</a></i>. When an
+   <code><a href="#input0">input</a></code> element is <i
+   title=concept-input-immutable><a href="#immutable">immutable</a></i>, the
+   user agent should not allow the user to modify the <a href="#value12"
+   title=concept-fe-value>value</a>.
 
   <p>When an <code><a href="#input0">input</a></code> element is <a
    href="#disabled4" title=concept-fe-disabled>disabled</a>, it is <i
@@ -28644,10 +28648,10 @@
    href="#dirty0">dirty</a></i>) when the element is created, and must be set
    to true (<i title=concept-input-dirty><a href="#dirty0">dirty</a></i>)
    whenever the user interacts with the control in a way that changes the <a
-   href="#value11" title=concept-fe-value>value</a>.
+   href="#value12" title=concept-fe-value>value</a>.
 
   <p>The <dfn id=value8 title=attr-input-value><code>value</code></dfn>
-   content attribute gives the default <a href="#value11"
+   content attribute gives the default <a href="#value12"
    title=concept-fe-value>value</a> of the <code><a
    href="#input0">input</a></code> element. When the <code
    title=attr-input-value><a href="#value8">value</a></code> content
@@ -28733,7 +28737,18 @@
   <p>When an <code><a href="#input0">input</a></code> element's <code
    title=attr-input-type><a href="#type12">type</a></code> attribute is in
    the <a href="#text2" title=attr-input-type-text>Text</a> state, the
-   element represents a text edit control for a single line of plain text.
+   element represents a one line plain text edit control for the element's <a
+   href="#value12" title=concept-fe-value>value</a>.
+
+  <p>If an <code><a href="#input0">input</a></code> element whose <code
+   title=attr-input-type><a href="#type12">type</a></code> attribute is in
+   the <a href="#text2" title=attr-input-type-text>Text</a> state is <i
+   title=concept-input-mutable><a href="#mutable">mutable</a></i>, its <a
+   href="#value12" title=concept-fe-value>value</a> should be editable by the
+   user. User agents must not allow users to insert U+000A LINE FEED (LF) or
+   U+000D CARRIAGE RETURN (CR) characters into the <a href="#value12"
+   title=concept-fe-value>value</a> of such <code><a
+   href="#input0">input</a></code> elements.
 
   <p><strong>The <a href="#text2" title=attr-input-type-text>Text</a> state's
    <a href="#control0">control initialization algorithm</a> is as
@@ -28744,20 +28759,15 @@
    <a href="#default2">default value change algorithm</a> is as
    follows:</strong> If the <code><a href="#input0">input</a></code> element
    is not <i title=concept-input-dirty><a href="#dirty0">dirty</a></i> then
-   set the <a href="#value11" title=concept-fe-value>value</a> of the element
+   set the <a href="#value12" title=concept-fe-value>value</a> of the element
    to the value of the <code title=attr-input-value><a
    href="#value8">value</a></code> content attribute and <a
    href="#strip">strip line breaks from the value</a>.
 
-  <p>If an <code><a href="#input0">input</a></code> element whose <code
-   title=attr-input-type><a href="#type12">type</a></code> attribute is in
-   the <a href="#text2" title=attr-input-type-text>Text</a> state is <i
-   title=concept-input-mutable><a href="#mutable">mutable</a></i>, its <a
-   href="#value11" title=concept-fe-value>value</a> should be editable by the
-   user. User agents must not allow users to insert U+000A LINE FEED (LF) or
-   U+000D CARRIAGE RETURN (CR) characters into the <a href="#value11"
-   title=concept-fe-value>value</a> of such <code><a
-   href="#input0">input</a></code> elements.
+  <p><strong>The <a href="#value10"><code title=dom-input-value>value</code>
+   setter algorithm</a> is as follows:</strong> Set the <a href="#value12"
+   title=concept-fe-value>value</a> of the element to the new value and <a
+   href="#strip">strip line breaks from the value</a>.
 
   <p>When an <code><a href="#input0">input</a></code> element's <code
    title=attr-input-type><a href="#type12">type</a></code> attribute is in
@@ -29020,7 +29030,7 @@
 
   <p>When a user agent is to <dfn id=strip>strip line breaks from the
    value</dfn>, the user agent must remove any U+000A LINE FEED (LF) and
-   U+000D CARRIAGE RETURN (CR) characters from <a href="#value11"
+   U+000D CARRIAGE RETURN (CR) characters from <a href="#value12"
    title=concept-fe-value>value</a>.
 
   <h5 id=common4><span class=secno>4.9.4.2. </span>Common <code><a
@@ -29100,8 +29110,15 @@
 
   <h6 id=value><span class=secno>4.9.4.3.1. </span>Value manipulation</h6>
 
-  <p class=big-issue>... <dfn id=value9
-   title=dom-input-value><code>value</code></dfn>
+  <p>The <dfn id=value9 title=dom-input-value><code>value</code></dfn> DOM
+   attribute allows secripts to manipulate the <span
+   title=concept-input-value>value</span> of an <code><a
+   href="#input0">input</a></code> element. On getting, it must return the
+   current <span title=concept-input-value>value</span> of the element. On
+   setting, it must run the <dfn id=value10><code
+   title=dom-input-value>value</code> setter algorithm</dfn> defined for the
+   element's <code title=attr-input-type><a href="#type12">type</a></code>
+   attribute's current state.
 
   <hr>
 
@@ -29482,7 +29499,7 @@
   <p class=big-issue>... <dfn id=selected1
    title=concept-option-selected>selected</dfn>
 
-  <p class=big-issue>... <dfn id=value10
+  <p class=big-issue>... <dfn id=value11
    title=concept-option-value>value</dfn>
 
   <p class=big-issue> <dfn id=option0
@@ -29791,7 +29808,7 @@
   <p class=big-issue>... <dfn id=disabled6
    title=dom-fe-disabled>disabled</dfn> DOM attribute
 
-  <p class=big-issue>... <dfn id=value11 title=concept-fe-value>value</dfn></p>
+  <p class=big-issue>... <dfn id=value12 title=concept-fe-value>value</dfn></p>
   <!-- XXX autocomplete: define somewhere that the value may be set from a stored value -->
 
   <h4 id=attributes2><span class=secno>4.9.14 </span><dfn
@@ -30138,7 +30155,7 @@
        href="#select">select</a></code> element that is <a href="#selected1"
        title=concept-option-selected>selected</a>, append an entry in the
        <var title="">form data set</var> with the <var title="">name</var> as
-       the name and the <a href="#value10"
+       the name and the <a href="#value11"
        title=concept-option-value>value</a> of the <code><a
        href="#option">option</a></code> element as the value.
 
@@ -30156,7 +30173,7 @@
 
      <li>
       <p>Otherwise, append an entry in the <var title="">form data set</var>
-       with <var title="">name</var> as the name and the <a href="#value11"
+       with <var title="">name</var> as the name and the <a href="#value12"
        title=concept-fe-value>value</a> of the <var title="">field</var>
        element as the value.
     </ol>

Received on Thursday, 18 September 2008 03:22:10 UTC