You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beehive.apache.org by do...@apache.org on 2005/08/31 18:33:56 UTC
svn commit: r265529 - in
/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui:
tagsFormControls.xml tagsHtmlMapping.xml
Author: dolander
Date: Wed Aug 31 09:33:52 2005
New Revision: 265529
URL: http://svn.apache.org/viewcvs?rev=265529&view=rev
Log:
Finish up the last of the form controls
Modified:
beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsFormControls.xml
beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsHtmlMapping.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=265529&r1=265528&r2=265529&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 Wed Aug 31 09:33:52 2005
@@ -13,7 +13,7 @@
to a single HTML element. The group controls map to more than one HTML element, for example
an <code><select></code> and <code><option></code> elements represent a select box.
In addition, the table summarizes the natural data type the control is usually bound to.
- Typicall, a form will post to an action that recieves a subclass of <code>FormData</code>
+ Typically, a form will post to an action that receives a subclass of <code>FormData</code>
which is populated with the values from the form by the framework before the action is called.
</p>
<table>
@@ -77,7 +77,7 @@
As a default the button acts as an HTML <code>type="submit"</code> button. You may
also create the button with a <code>type</code> of <code>reset</code> or <code>button</code>.
In the example below, when the users presses the generated button it will cause the form
- to be submited. The button must appear within the <code><netui:form></code>
+ to be submitted. The button must appear within the <code><netui:form></code>
</p>
<p> The button does not bind to a <code>dataSource</code> of any type.
</p>
@@ -157,7 +157,7 @@
<a href="site:pageflow_tag_repeating">repeater</a>. This allows for
control of both the layout and the presentation of the options.
</p>
- <p> In the following example, the a CheckBoxGroup contains four children defined
+ <p> In the following example, a CheckBoxGroup contains four children defined
through options. When the form is posted, all of the values that are selected
(checked) will be posted back to an array in the <code>FormData</code>.
</p>
@@ -231,7 +231,7 @@
<netui:fileUpload dataSource="actionForm.fileUpload"/>
</netui:form>
</source>
- <p> The following is the <code>FormData</code> property that will recieve the
+ <p> The following is the <code>FormData</code> properties that will receive the
information and data associated with the file that was uploaded.
</p>
<source>
@@ -273,7 +273,7 @@
parameter that is a
subclass of <code>FormData</code> a bean will be populated by the page flow framework
with values posted by the controls contained in the form. In the example below,
- the form will call the page flow <code>submit</code> action.
+ the form will call the page flow's <code>submit</code> action.
</p>
<source>
<netui:form <strong>action="submit"</strong>>
@@ -368,7 +368,7 @@
<section id="ImageButton">
<title>ImageButton</title>
<p> The <code><netui:imageButton></code> creates the HMTL <code><input type="image"</code>
- element. The result is a image is used to submit the form. The source of the image
+ element. The result is an image is used to submit the form. The source of the image
is specified in the <code>src</code> attribute. The ImageButton does not bind to any
data. In addition, it must appear inside of the form.
</p>
@@ -395,7 +395,7 @@
on <a href="site:pageflow_tag_repeating_radiobuttongroup">Repeating RadioButtonGroup</a>.
</p>
- <p> There are two methods for creating the options whichc create the radio buttons
+ <p> There are two methods for creating the options which render the radio buttons
inside of the group. The body of the tag may contain <code><netui:RadioButtonOptions></code>
tags or the <code>optionsDataSource</code> my bind to an array of values. When using the
<code>optionsDataSource</code>, this tag may act as a
@@ -404,7 +404,7 @@
</p>
<p> In the following example, the RadioButtonGroup contains four options defined through
the RadioButtonOption tag. When the form is posted, if one of the options
- is selected it's <code>value</code> will be posted back.
+ is selected its <code>value</code> will be posted back.
</p>
<source><![CDATA[
<netui:radioButtonGroup dataSource="actionForm.radioButtonGroup" orientation="vertical">
@@ -416,7 +416,7 @@
]]></source>
<p> The natural binding for a <code><netui:radioButtonGroup></code> is a
<code>java.lang.String</code>. The following property defined in the <code>FormData</code>
- recieves the results of posting the form.
+ receives the results of posting the form.
</p>
<source>
private String radioButtonGroup;
@@ -455,7 +455,7 @@
<title>Select</title>
<p> The <code><netui:select></code> is a control allowing a user to select one
or more items from a list of items. There
- are two primary modes, single selection and multiple selection. There are two ways to
+ are two primary modes, single selection and multiple selections. There are two ways to
specify the items of the select control, you may use the <code><netui:selectOption></code>
or the <code>optionsDataSource</code> attribute on the tag. For more information on
see the <a href="#SelectOption">SelectOption</a> topic. In addition, the select supports a
@@ -546,9 +546,52 @@
</section>
<section id="TextArea">
<title>TextArea</title>
+ <p> The <code><netui:textArea></code> creates a multiple line text entry control. It maps
+ to the HTML <code><textArea></code> element. It is very common to set the <code>rows</code>
+ and <code>cols</code> attributes to set the size of the text area on the page. The natural
+ data type that is bound to is <code>java.lang.String</code>. In the code below a text area
+ is defined and binds to a property in the <code>actionForm</code>.
+ </p>
+ <source>
+<netui:textArea dataSource="actionForm.textArea" />
+ </source>
+ <p> The following property of the <code>FormData</code> receives the posted value:
+ </p>
+ <source>
+private String textArea;
+
+public String getTextArea() {
+ return textArea;
+}
+public void setTextArea(String textArea) {
+ this.textArea = textArea;
+}
+ </source>
</section>
<section id="TextBox">
<title>TextBox</title>
+ <p> The <code><netui:textBox></code> creates a single line text entry control. The
+ tag supports
+ either <code>text</code> or <code>password</code> by setting the <code>type</code> attribute.
+ The default is <code>text</code>. The natural
+ data type bound to by a text box is <code>java.lang.String</code>. The code below creates
+ a text box and binds it to a propery in the <code>actionForm</code>
+ </p>
+ <source>
+<netui:textBox dataSource="actionForm.textBox" />
+ </source>
+ <p> The following property of the <code>FormData</code> receives the posted value:
+ </p>
+ <source>
+private String textBox;
+
+public String getTextBox() {
+ return textBox;
+}
+public void setTextBox(String textBox) {
+ this.textBox = textBox;
+}
+ </source>
</section>
</body>
</document>
Modified: beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsHtmlMapping.xml
URL: http://svn.apache.org/viewcvs/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsHtmlMapping.xml?rev=265529&r1=265528&r2=265529&view=diff
==============================================================================
--- beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsHtmlMapping.xml (original)
+++ beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tagsHtmlMapping.xml Wed Aug 31 09:33:52 2005
@@ -93,10 +93,12 @@
<td><span></td><td>netui:span</td><td>Create an inline span element</td><td></td>
</tr>
<tr>
- <td><textArea></td><td>netui:textArea</td><td>Form Control creating a multiple line text input field</td><td></td>
+ <td><textArea></td><td>netui:textArea</td><td>Form Control creating a multiple line text input field</td>
+ <td><a href="site:pageflow_tag_formControls_textarea">Form Controls</a></td>
</tr>
<tr>
- <td><input type={text, password}</td><td>netui:textBox</td><td>Form Control creating either a text or password field</td><td></td>
+ <td><input type={text, password}</td><td>netui:textBox</td><td>Form Control creating either a text or password field</td>
+ <td><a href="site:pageflow_tag_formControls_textbox">Form Controls</a></td>
</tr>
</table>
</section>