W3C home > Mailing lists > Public > public-html-commits@w3.org > August 2009

html5/spec Overview.html,1.2830,1.2831

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Mon, 17 Aug 2009 09:47:32 +0000
To: public-html-commits@w3.org
Message-Id: <E1McyoO-0004XC-Fx@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv17412

Modified Files:
	Overview.html 
Log Message:
A brief and vague introduction to form submission. (whatwg r3645)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2830
retrieving revision 1.2831
diff -u -d -r1.2830 -r1.2831
--- Overview.html	17 Aug 2009 03:04:00 -0000	1.2830
+++ Overview.html	17 Aug 2009 09:47:29 -0000	1.2831
@@ -31896,7 +31896,7 @@
   <p>The <a href="#attributes-for-form-submission">attributes for form submission</a> that may be
   specified on <code><a href="#the-form-element">form</a></code> elements are <code title="attr-fs-action"><a href="#attr-fs-action">action</a></code>, <code title="attr-fs-enctype"><a href="#attr-fs-enctype">enctype</a></code>, <code title="attr-fs-method"><a href="#attr-fs-method">method</a></code>, <code title="attr-fs-novalidate"><a href="#attr-fs-novalidate">novalidate</a></code>, and <code title="attr-fs-target"><a href="#attr-fs-target">target</a></code>.<p>The corresponding <a href="#attributes-for-form-submission">attributes for form submission</a>
   that may be specified on <a href="#concept-submit-button" title="concept-submit-button">submit
-  button</a> are <code title="attr-fs-formaction"><a href="#attr-fs-formaction">formaction</a></code>, <code title="attr-fs-formenctype"><a href="#attr-fs-formenctype">formenctype</a></code>, <code title="attr-fs-formmethod"><a href="#attr-fs-formmethod">formmethod</a></code>, <code title="attr-fs-formnovalidate"><a href="#attr-fs-formnovalidate">formnovalidate</a></code>, and <code title="attr-fs-formtarget"><a href="#attr-fs-formtarget">formtarget</a></code>. When omitted, they
+  buttons</a> are <code title="attr-fs-formaction"><a href="#attr-fs-formaction">formaction</a></code>, <code title="attr-fs-formenctype"><a href="#attr-fs-formenctype">formenctype</a></code>, <code title="attr-fs-formmethod"><a href="#attr-fs-formmethod">formmethod</a></code>, <code title="attr-fs-formnovalidate"><a href="#attr-fs-formnovalidate">formnovalidate</a></code>, and <code title="attr-fs-formtarget"><a href="#attr-fs-formtarget">formtarget</a></code>. When omitted, they
   default to the values given on the corresponding attributes on the
   <code><a href="#the-form-element">form</a></code> element.<hr><p>The <dfn id="attr-fs-action" title="attr-fs-action"><code>action</code></dfn> and
   <dfn id="attr-fs-formaction" title="attr-fs-formaction"><code>formaction</code></dfn>
@@ -32391,7 +32391,29 @@
 
   <h5 id="introduction-0"><span class="secno">4.10.16.1 </span>Introduction</h5>
 
-  </div><p><i>This section is non-normative.</i><p class="XXX"> ... <div class="impl">
+  </div><p><i>This section is non-normative.</i><p>When forms are submitted, the data in the form is converted into
+  the form specified by the <a href="#concept-fs-enctype" title="concept-fs-enctype">enctype</a>, and then sent to the
+  destination specified by the <a href="#concept-fs-action" title="concept-fs-action">action</a> using the given <a href="#concept-fs-method" title="concept-fs-method">method</a>.<p>For example, take the following form:<pre>&lt;form action="/find.cgi" method=get&gt;
+ &lt;input type=text name=t&gt;
+ &lt;input type=search name=q&gt;
+ &lt;input type=submit&gt;
+&lt;/form&gt;</pre><p>If the user types in "cats" in the first field and "fur" in the
+  second, and then hits the submit button, then the user agent will
+  load <code title="">.../find.cgi?t=cats&amp;q=fur</code>.<p>On the other hand, consider this form:<pre>&lt;form action="/find.cgi" method=post enctype="multipart/form-data"&gt;
+ &lt;input type=text name=t&gt;
+ &lt;input type=search name=q&gt;
+ &lt;input type=submit&gt;
+&lt;/form&gt;</pre><p>Given the same user input, the result on submission is quite
+  different: the user agent instead does an HTTP POST to the given
+  URL, with as the entity body something like the following text:<pre>------kYFrd4jNJEgCervE
+Content-Disposition: form-data; name="t"
+
+cats
+------kYFrd4jNJEgCervE
+Content-Disposition: form-data; name="q"
+
+fur
+------kYFrd4jNJEgCervE--</pre><div class="impl">
 
   <h5 id="implicit-submission"><span class="secno">4.10.16.2 </span>Implicit submission</h5>
 
@@ -32653,12 +32675,12 @@
     of each column. Then, jump to the steps named in that cell and
     defined below the table.</p>
 
-    <table><tr><td>
+    <table><thead><tr><td>
       <th> <a href="#attr-fs-method-get" title="attr-fs-method-GET">GET</a>
       <th> <a href="#attr-fs-method-post" title="attr-fs-method-POST">POST</a>
       <th> <a href="#attr-fs-method-put" title="attr-fs-method-PUT">PUT</a>
       <th> <a href="#attr-fs-method-delete" title="attr-fs-method-DELETE">DELETE</a>
-     <tr><th> <code title="">http</code>
+     <tbody><tr><th> <code title="">http</code>
       <td> <a href="#submit-mutate-action" title="submit-mutate-action">Mutate action</a>
       <td> <a href="#submit-body" title="submit-body">Submit as entity body</a>
       <td> <a href="#submit-body" title="submit-body">Submit as entity body</a>
Received on Monday, 17 August 2009 09:47:43 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 17 August 2009 09:47:45 GMT