svn commit: r264818 - in /beehive/trunk/docs/forrest/release/src/documentation/content/xdocs: netui/tagsFormControls.xml site.xml

[do...@apache.org]

Author: dolander
Date: Tue Aug 30 10:31:06 2005
New Revision: 264818

URL: http://svn.apache.org/viewcvs?rev=264818&view=rev
Log:
Update the Form Controls document


Modified:
    beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsFormControls.xml
    beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/site.xml

Modified: beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsFormControls.xml
URL: http://svn.apache.org/viewcvs/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsFormControls.xml?rev=264818&r1=264817&r2=264818&view=diff
==============================================================================
--- beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsFormControls.xml (original)
+++ beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsFormControls.xml Tue Aug 30 10:31:06 2005
@@ -10,43 +10,90 @@
             <title>NetUI Form Control Tags</title>
             <p></p>
             <table>
-              <tr>
-                <th>original tag</th><th>replace with</th><th><code>FormData</code> datatype</th>
-              </tr>
-              <tr>
-                <td>button</td><td>netui:button</td><td><em>optionally changing the controller form processing method</em></td>
-              </tr>
-              <tr>
-                <td>input type="checkbox"</td><td>netui:checkBox</td><td><code>boolean</code> or <code>java.lang.Boolean</code></td>
-              </tr>
-              <tr>
-                <td>input type="checkbox"</td><td>netui:checkBoxGroup</td><td><code>java.lang.String[]</code></td>
-              </tr>
-              <tr>
-                <td>input type="checkbox"</td><td>netui:checkBoxOption</td><td><em>see <code>netui:checkBoxGroup</code></em></td>
-              </tr>
-              <tr>
-                <td>hidden</td><td>netui:hidden</td><td><code>java.lang.String</code></td>
-              </tr>
-              <tr>
-                <td>input type="radio"</td><td>netui:radioButtonGroup</td><td><code>java.lang.String[]</code></td>
-              </tr>
-              <tr>
-                <td>input type="radio"</td><td>netui:radioButtonOption</td><td><em>see <code>netui:radioButtonGroup</code></em></td>
-              </tr>
-              <tr>
-                <td>input type="radio"</td><td>netui:select</td><td><code>java.lang.String[]</code></td>
-              </tr>
-              <tr>
-                <td>option</td><td>netui:option</td><td>see <code>netui:option</code></td>
-              </tr>
-              <tr>
-                <td>textarea</td><td>netui:textArea</td><td><code>java.lang.String</code></td>
-              </tr>
-              <tr>
-                <td>input (type="text")</td><td>netui:textBox</td><td><code>java.lang.String</code></td>
-              </tr>
+                <tr><th>NetUI Form Control</th><th>Binding Data Type</th>
+                </tr>
+                <tr><td>&lt;netui:anchor></td><td>None</td></tr>
+                <tr><td>&lt;netui:button></td><td>None</td></tr>
+                <tr><td>&lt;netui:checkBox></td><td><code>boolean</code> or <code>java.lang.Boolean</code> or
+                    <code>java.lang.String</code></td></tr>
+                <tr><td>&lt;netui:checkBoxGroup></td><td><code>java.lang.String[]</code></td></tr>
+                <tr><td>&lt;netui:checkBoxOption></td><td>None, See the <code>checkBoxGroup</code> tag</td></tr>
+                <tr><td>&lt;netui:fileUpload></td><td>org.apache.struts.upload.FormFile</td></tr>
+                <tr><td>&lt;netui:form></td><td>None</td></tr>
+                <tr><td>&lt;netui:hidden></td><td><code>java.lang.String</code> or <code>java.lang.String[]</code></td></tr>
+                <tr><td>&lt;netui:imageButton></td><td>None</td></tr>
+                <tr><td>&lt;netui:radioButtonGroup></td><td><code>java.lang.String[]</code></td></tr>
+                <tr><td>&lt;netui:radioButtonOption></td><td>None, See the <code>radioButtonGroup</code> tag</td></tr>
+                <tr><td>&lt;netui:select></td><td><code>java.lang.String</code> or <code>java.lang.String[]</code></td></tr>
+                <tr><td>&lt;netui:selectOption></td><td>None, See the <code>select</code> tag</td></tr>
+                <tr><td>&lt;netui:textArea></td><td><code>java.lang.String[]</code></td></tr>
+                <tr><td>&lt;netui:textBox></td><td><code>java.lang.String[]</code></td></tr>
             </table>
+            <p></p>
+            <section id="Anchor">
+                <title>Anchor</title>
+                <p> Though not technically a form control, the <code>&lt;netui:anchor></code> can be used to
+                    submit a form.  It does this through a JavaScript function that is dynamically added to the page.
+                    In the following example the anchor is found inside of the <code>&lt;netui:form></code>, which
+                    is a requirement for using a anchor to submit a form.  In order to submit a form, the
+                    <code>formSubmit</code> attribute is set to <code>true</code>.  In addition, there
+                    is no requirement to set an <code>action</code> or <code>href</code> on the anchor.
+                </p>
+                <p> The anchor doesn't bind to a <code>dataSource</code> of any type.
+                </p>
+                <source>
+&lt;netui:form>
+   ...
+   &lt;netui:anchor  <strong>formSubmit="true"</strong>>Submit Form Through a Link&lt;/netui:anchor>
+&lt;/netui:form>
+                </source>
+                <p> There is a bit of generated JavaScript in the rendered page that will submit the form.
+                    See <a href="site:pageflow_tag_javascript">Tags Support for JavaScript</a> for details
+                    on how the framework generated JavaScript is supported.  Below is the rendered
+                    HTML <code>&lt;a></code>, which calls the framework
+                    <code>generated anchor_submit_form</code> function.
+                </p>
+                <source>
+&lt;a href="/dev/formControls/submit.do"
+    <strong>onclick="anchor_submit_form('Netui_Form_0','/dev/formControls/submit.do');return false;"</strong>>Submit Form Through a Link&lt;/a>
+                </source>
+            </section>
+            <section id="Button">
+                <title>Button</title>
+            </section>
+            <section id="CheckBox">
+                <title>CheckBox</title>
+            </section>
+            <section id="CheckBoxGroup">
+                <title>CheckBoxGroup</title>
+            </section>
+            <section id="CheckBoxOption">
+                <title>CheckBoxOption</title>
+            </section>
+            <section id="FileUpload">
+                <title>FileUpload</title>
+            </section>
+            <section id="Form">
+                <title>Form</title>
+            </section>
+            <section id="Hidden">
+                <title>Hidden</title>
+            </section>
+            <section id="ImageButton">
+                <title>ImageButton</title>
+            </section>
+            <section id="RadioButtonGroup">
+                <title>RadioButtonGroup</title>
+            </section>
+            <section id="RadioButtonOption">
+                <title>RadioButtonOption</title>
+            </section>
+            <section id="TextArea">
+                <title>TextArea</title>
+            </section>
+            <section id="TextBox">
+                <title>TextBox</title>
+            </section>
         </section>
     </body>
 </document>

Modified: beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/site.xml
URL: http://svn.apache.org/viewcvs/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/site.xml?rev=264818&r1=264817&r2=264818&view=diff
==============================================================================
--- beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/site.xml (original)
+++ beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/site.xml Tue Aug 30 10:31:06 2005
@@ -32,7 +32,8 @@
             <pageflow_tags label="Tags">
                 <pageflow_tag_overview label="Overview" href="netui/tagsOverview.html" />
                 <pageflow_tag_htmlMapping label="HTML Mapping" href="netui/tagsHtmlMapping.html" />
-                <pageflow_tag_formControls label="Form Controls" href="netui/tagsFormControls.html" />
+                <pageflow_tag_formControls label="Form Controls" href="netui/tagsFormControls.html">
+                </pageflow_tag_formControls>
                 <pageflow_tag_xhtml label="HTML/XHTML Support" href="netui/tagsXhtml.html">
                     <pageflow_tagsXhtml_HtmlTag href="#HtmlTag" />
                     <pageflow_tagsXhtml_BodyTag href="#BodyTag" />