- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 17 Aug 2009 09:47:32 +0000
- To: public-html-commits@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><form action="/find.cgi" method=get> + <input type=text name=t> + <input type=search name=q> + <input type=submit> +</form></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&q=fur</code>.<p>On the other hand, consider this form:<pre><form action="/find.cgi" method=post enctype="multipart/form-data"> + <input type=text name=t> + <input type=search name=q> + <input type=submit> +</form></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 UTC