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>
