home *** CD-ROM | disk | FTP | other *** search
/ Computer Shopper 133 / dpcs0399.iso / INTERNET / COFFEE / HTMLED55 / SETUP.EXE / file0135.bin < prev    next >
Encoding:
Text File  |  1998-11-04  |  14.1 KB  |  128 lines
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"
  2.    "http://www.w3.org/TR/REC-html40/strict.dtd">
  3. <html lang=en>
  4. <head>
  5. <title>FORM - Interactive Form</title>
  6. <link rev=Made href="mailto:liam@htmlhelp.com">
  7. <link rel=Start href="../index.html">
  8. <link rel=Glossary href="http://www.htmlhelp.com/glossary/glossary.html">
  9. <link rel=Copyright href="http://www.htmlhelp.com/copyright.html">
  10. <link rel=StyleSheet href="../style.css" type="text/css">
  11. <link rel=StyleSheet href="../aural.css" type="text/css" media=aural>
  12. <meta http-equiv="Content-Script-Type" content="text/javascript">
  13. <meta name="author" content="Liam Quinn">
  14. <meta name="description" content="A description of HTML 4.0's FORM element for interactive forms.">
  15. <meta name="keywords" content="FORM, form element, forms, HyperText Markup Language, HTML, HTML4, HTML 4.0, Web Design Group, WDG, <form> tag, <FORM> tag">
  16. <script type="text/javascript">
  17. <!--
  18. function toggle() {
  19.   if (document.all.toggler.value == "Hide non-strict elements and attributes") {
  20.      document.styleSheets[0].addRule("div.transitional", "display:none");
  21.      document.styleSheets[0].addRule("span.transitional", "display:none");
  22.      document.styleSheets[0].addRule("li.transitional", "display:none");
  23.      document.styleSheets[0].addRule(".transitional", "speak:none");
  24.      document.all.toggler.value = "Show non-strict elements and attributes";
  25.   } else {
  26.      document.styleSheets[0].addRule("div.transitional", "display:block");
  27.      document.styleSheets[0].addRule("span.transitional", "display:inline");
  28.      document.styleSheets[0].addRule("li.transitional", "display:list-item");
  29.      document.styleSheets[0].addRule(".transitional", "speak:inherit");
  30.      document.all.toggler.value = "Hide non-strict elements and attributes";
  31.   }
  32. }
  33. // -->
  34. </script>
  35. </head>
  36. <body>
  37. <h2><img src="../wdglogo1.gif" width=250 height=83 alt="The Web Design Group"></h2>
  38. <h1>FORM - Interactive Form</h1>
  39. <script type="text/javascript">
  40. <!--
  41.   if (document.styleSheets) {
  42.     var gt;
  43.     gt = unescape(new String("%3E"));
  44.  
  45.     document.write("<p" + gt + "<input type=button value=\"Hide non-strict elements and attributes\" id=toggler accesskey=s onclick=\"toggle()\"" + gt + "<\/p" + gt);
  46.   }
  47. // -->
  48. </script>
  49. <table>
  50.   <tr valign=top>
  51.     <th>Syntax</th>
  52.     <td><strong class=required><FORM></strong>...<strong class=required></FORM></strong></td>
  53.   </tr>
  54.   <tr valign=top>
  55.     <th>Attribute Specifications</th>
  56.     <td>
  57.       <ul>
  58.         <li><strong class=required>ACTION=<var><a href="../values.html#uri">URI</a></var> (form handler)</strong></li>
  59.         <li>METHOD=[ <em class=default>get</em> | postá] (<abbr class=initialism title="HyperText Transfer Protocol">HTTP</abbr> method for submitting form)</li>
  60.         <li>ENCTYPE=<var><a href="../values.html#contenttype">ContentType</a></var> (content type to submit form as)</li>
  61.         <li>ACCEPT-CHARSET=<var><a href="../values.html#charsets">Charsets</a></var> (supported character encodings)</li>
  62.         <li class=transitional>TARGET=<var><a href="../values.html#frametarget">FrameTarget</a></var> (frame to render form result in)</li>
  63.         <li>ONSUBMIT=<var><a href="../values.html#script">Script</a></var> (form was submitted)</li>
  64.         <li>ONRESET=<var><a href="../values.html#script">Script</a></var> (form was reset)</li>
  65.         <li><a href="../attrs.html">common attributes</a></li>
  66.       </ul>
  67.     </td>
  68.   </tr>
  69.   <tr valign=top>
  70.     <th>Contents</th>
  71.     <td>
  72.       <ul>
  73.         <li>In <a href="../html/doctype.html#strict">HTMLá4.0 Strict</a>, one or more <a href="../special/script.html">SCRIPT</a> or <a href="../block.html">block-level elements</a> except FORM</li>
  74.         <li class=transitional>In <a href="../html/doctype.html#transitional">HTMLá4.0 Transitional</a>, <a href="../inline.html">inline elements</a> or <a href="../block.html">block-level elements</a> except FORM</li>
  75.       </ul>
  76.     </td>
  77.   </tr>
  78.   <tr valign=top>
  79.     <th>Contained in</th>
  80.     <td><span class=transitional><a href="../special/applet.html">APPLET</a>, </span><a href="../block/blockquote.html">BLOCKQUOTE</a>, <a href="../html/body.html">BODY</a>, <span class=transitional><a href="../block/center.html">CENTER</a>, </span><a href="../lists/dd.html">DD</a>, <a href="../phrase/del.html">DEL</a>, <a href="../block/div.html">DIV</a>, <a href="fieldset.html">FIELDSET</a>, <span class=transitional><a href="../special/iframe.html">IFRAME</a>, </span><a href="../phrase/ins.html">INS</a>, <a href="../lists/li.html">LI</a>, <a href="../special/map.html">MAP</a>, <span class=transitional><a href="../frames/noframes.html">NOFRAMES</a>, </span><a href="../block/noscript.html">NOSCRIPT</a>, <a href="../special/object.html">OBJECT</a>, <a href="../tables/td.html">TD</a>, <a href="../tables/th.html">TH</a></td>
  81.   </tr>
  82. </table>
  83. <p>The <strong class=html>FORM</strong> element defines an <em>interactive form</em>. The element should contain form controls--<strong class=html><a href="input.html">INPUT</a></strong>, <strong class=html><a href="select.html">SELECT</a></strong>, <strong class=html><a href="textarea.html">TEXTAREA</a></strong>, and <strong class=html><a href="button.html">BUTTON</a></strong>--through which the user interacts.</p>
  84. <p>When the user submits the form, through an <strong class=html>INPUT</strong> or <strong class=html>BUTTON</strong> element with <strong class=html>TYPE=submit</strong>, the form values are submitted to the <abbr class=initialism title="Uniform Resource Identifier">URI</abbr> given in <strong class=html>FORM</strong>'s required <strong class=html>ACTION</strong> attribute. <strong class=html>ACTION</strong> usually points to a <abbr class=initialism title="Common Gateway Interface">CGI</abbr> script or Java servlet that handles the form submission.</p>
  85. <div class=note>
  86. <p>A mailto <abbr class=initialism title="Uniform Resource Identifier">URI</abbr> (<abbr title="for example"><i lang=la>e.g.</i></abbr>, <strong class=html>mailto:liam@htmlhelp.com</strong>) is also allowed as an <strong class=html>ACTION</strong>, but this is not supported by all browsers. Non-supporting browsers such as Microsoft Internet Explorerá3.<var>x</var> typically will open a blank e-mail message when the user submits a mailto form. Even on supporting browsers, mailto forms are troublesome in that they fail to provide feedback to the user after the form submission.</p>
  87. <p><a href="http://www.cgi-resources.com/Programs_and_Scripts/">Free <abbr class=initialism title="Common Gateway Interface">CGI</abbr> scripts</a> exist for handling forms; some are even <a href="http://www.cgi-resources.com/Programs_and_Scripts/Remotely_Hosted/Form_Processing/">remotely hosted</a> for authors whose providers refuse to allow <abbr class=initialism title="Common Gateway Interface">CGI</abbr> scripts to be run locally.</p>
  88. </div>
  89. <p>How the form input is sent to the server depends on the <strong class=html>METHOD</strong> and <strong class=html>ENCTYPE</strong> attributes. When the <strong class=html>METHOD</strong> is <strong class=html>get</strong> (the default), the form input is submitted as an <abbr class=initialism title="HyperText Transfer Protocol">HTTP</abbr> GET request with <strong class=html>?<var>form_data</var></strong> appended to the <abbr class=initialism title="Uniform Resource Identifier">URI</abbr> specified in the <strong class=html>ACTION</strong> attribute.</p>
  90. <p>Using the <strong class=html>get</strong> method allows the form submission to be contained completely in a <abbr class=initialism title="Uniform Resource Locator">URL</abbr>. This can be advantageous in that it permits bookmarking in current browsers, but it also prevents form data from containing non-<acronym title="American Standard Code for Information Interchange">ASCII</acronym> characters such as "Θ" and "⌐". As well, the amount of form data that can be handled by the <strong class=html>get</strong> method is limited by the maximum length of the <abbr class=initialism title="Uniform Resource Locator">URL</abbr> that the server and browser can process. To be safe, any form whose input might contain non-<acronym title="American Standard Code for Information Interchange">ASCII</acronym> characters or more than 100 characters should use <strong class=html>METHOD=post</strong>.</p>
  91. <p>With a <strong class=html>METHOD</strong> value of <strong class=html>post</strong>, the form input is submitted as an <abbr class=initialism title="HyperText Transfer Protocol">HTTP</abbr> POST request with the form data sent in the body of the request. Most current browsers are unable to bookmark POST requests, but POST does not entail the character encoding and length restrictions imposed by GET.</p>
  92. <p>The <strong class=html>ENCTYPE</strong> attribute specifies the content type used in submitting the form, and defaults to <strong class=html>application/x-www-form-urlencoded</strong>. This content type results in name/value pairs sent to the server as <var>name1</var>=<var>value1</var>&<var>name2</var>=<var>value2...</var> with space characters replaced by "+" and reserved characters (like "#") replaced by "%<var>HH</var>" where <var>HH</var> is the <acronym title="American Standard Code for Information Interchange">ASCII</acronym> code of the character in hexadecimal. Line breaks are encoded as "%0D%0A"--a carriage return followed by a line feed.</p>
  93. <p>Authors should generally only use a different <strong class=html>ENCTYPE</strong> when the form includes a <strong class=html>TYPE=file</strong> <strong class=html><a href="input.html">INPUT</a></strong> element, in which case the <strong class=html>ENCTYPE</strong> should be <strong class=html>multipart/form-data</strong> and the <strong class=html>METHOD</strong> must be <strong class=html>post</strong>. The format of multipart/form-data requests is given in <cite><a href="http://ds.internic.net/rfc/rfc1867.txt" title="Form-based File Upload in HTML"><abbr class=initialism title="Request for Comments">RFC</abbr> 1867</a></cite>.</p>
  94. <p class=note>Tools such as <a href="http://www.htmlhelp.com/tools/cg-eye/">cg-eye</a> allow authors to easily create and view a request, simulating the submission of a form. However, authors often do not need to concern themselves with the exact format of the submission; <abbr class=initialism title="Common Gateway Interface">CGI</abbr> libraries including <a href="http://www-genome.wi.mit.edu/ftp/pub/software/WWW/cgi_docs.html" title="CGI.pm - a Perl5 CGI Library">CGI.pm</a> transparently handle <strong class=html>get</strong> and <strong class=html>post</strong> submissions sent as application/x-www-form-urlencoded or multipart/form-data.</p>
  95. <p>The <strong class=html>ACCEPT-CHARSET</strong> attribute specifies a list of character encodings that are accepted by the form handler. The value consists of a list of "charsets" separated by commas and/or spaces. The default value is <strong class=html>UNKNOWN</strong> and is usually considered to be the character encoding used to transmit the document containing the <strong class=html>FORM</strong>.</p>
  96. <div class=transitional>
  97. <p>The <strong class=html>TARGET</strong> attribute is used with <a href="../frames/index.html">frames</a> to specify in which frame the form response should be rendered. If no frame with such a name exists, the response is rendered in a new window unless overridden by the user. Special frame names begin with an underscore:</p>
  98. <ul>
  99.   <li><strong class=html>_blank</strong> renders the response in a new, unnamed window</li>
  100.   <li><strong class=html>_self</strong> renders the response in the current frame (useful for overriding a <strong class=html><a href="../head/base.html">BASE</a> TARGET</strong>)</li>
  101.   <li><strong class=html>_parent</strong> renders the response in the immediate <strong class=html><a href="../frames/frameset.html">FRAMESET</a></strong> parent</li>
  102.   <li><strong class=html>_top</strong> renders the response in the full, unframed window</li>
  103. </ul>
  104. </div>
  105. <p>The <strong class=html>FORM</strong> element also takes a number of attributes to specify client-side scripting actions for various events. In addition to the <a href="../attrs.html#events">core events</a> common to most elements, <strong class=html>INPUT</strong> accepts the following event attributes:</p>
  106. <ul>
  107.   <li><strong class=html>ONSUBMIT</strong>, when the form is submitted;</li>
  108.   <li><strong class=html>ONRESET</strong>, when the form is reset.</li>
  109. </ul>
  110. <h2>More Information</h2>
  111. <ul>
  112.   <li><a href="http://www.w3.org/TR/REC-html40/interact/forms.html#edef-FORM">FORM in <abbr class=initialism title="World Wide Web Consortium">W3C</abbr> HTMLá4.0 Recommendation</a></li>
  113.   <li><a href="http://www.w3.org/TR/REC-html32#form">FORM in <abbr class=initialism title="World Wide Web Consortium">W3C</abbr> HTMLá3.2 Recommendation</a></li>
  114.   <li><a href="http://www.w3.org/MarkUp/html-spec/html-spec_8.html#SEC8.1.1">FORM in HTMLá2.0 Standard</a></li>
  115.   <li><a href="http://www.htmlhelp.com/reference/wilbur/block/form.html">FORM in <abbr class=initialism title="Web Design Group">WDG</abbr> HTMLá3.2 Reference</a></li>
  116.   <li><a href="http://www.hut.fi/u/jkorpela/HTML3.2/5.25.html">FORM in <cite>Learning HTMLá3.2 by Examples</cite></a></li>
  117.   <li><a href="http://ds.internic.net/rfc/rfc1867.txt"><abbr class=initialism title="Request for Comments">RFC</abbr> 1867: Form-based File Upload in HTML</a></li>
  118.   <li><a href="http://hoohoo.ncsa.uiuc.edu/cgi/">The Common Gateway Interface</a></li>
  119.   <li><a href="http://java.sun.com/products/java-server/servlets/index.html">Java Servlets</a></li>
  120. </ul>
  121. <div class=footer>
  122. <address>Maintained by <a href="http://www.htmlhelp.com/%7Eliam/">Liam Quinn</a> <<a href="mailto:liam@htmlhelp.com">liam@htmlhelp.com</a>></address>
  123. <p class=toolbar><a href="http://www.htmlhelp.com/"><img src="../wdglogo-small.gif" width=105 height=40 alt="Web Design Group ~"></a> <a href="../index.html" rel=Start>HTMLá4.0áReference</a>á~ <a href="../olist.html">ElementsábyáFunction</a>á~ <a href="../alist.html">ElementsáAlphabetically</a></p>
  124. <p class=copyright><a href="http://www.htmlhelp.com/copyright.html">Copyright ⌐</a> 1998 Liam Quinn. All rights reserved.</p>
  125. </div>
  126. </body>
  127. </html>
  128.