blob: d6849bd0d782445913b542043b5ab2ea44cccdd0 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- $Id$ -->
<html>
<head>
<title>TextArea</title>
<link rel="stylesheet" type="text/css" href="Tapestry.css" title="style">
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td align="left"><A href="Submit.html"><IMG alt=Submit src="common-images/prev.png"></A></td>
<td align="middle"><A href="index.html"><IMG alt="Component Index" src="common-images/home.png" ></A></td>
<td align="right"><A href="TextField.html"><IMG alt=TextField src="common-images/next.png"></A></td>
<tr>
<tr>
<td colspan="3"><hr></td>
</tr>
<tr>
<td colspan="3">
<table border="0" cellpadding="4" cellspacing="4" width="100%">
<tr valign="top">
<td>
<table>
<tr>
<td><font size="+2"><b>TextArea</b></font></td>
</tr>
<tr>
<td>
<A href="../api/org/apache/tapestry/form/TextArea.html">
org.apache.tapestry.form.TextArea</A>
</td>
</tr>
</table>
</td>
<td>
<table align="right" valign="middle" bgcolor="#c0c0c0" cellspacing="8">
<tr>
<td>Text Input:</td>
<td><TEXTAREA name=textarea rows=3></TEXTAREA></td>
</tr>
</table>
</td>
</tr>
<tr valign="center">
<td colspan="2">&nbsp;</td>
</tr>
<tr>
<td colspan="2">
<b>Description</b>
<br>
Provides a HTML &lt;textarea&gt; form element.
This component must be wrapped by a <A href="Form.html">Form</A> component.
<p>
Use the HTML "wrap" attribute as an informal
parameter to control word wrapping. Wrap attribute values include:
"off", "vitual", "physical", "soft" and "hard".</p>
<P>Prior to release 2.2, this component was named
<STRONG>Text</STRONG>.</P>
</td>
</tr>
<tr>
<td colspan="2">
<b>See Also</b>
<br>
<A href="Form.html">Form</A>,
<A href="TextField.html">TextField</A>
</td>
</tr>
<tr>
<td colspan="2">
<b>Parameters</b>
<br>
<table border="1" cellpadding="4" cellspacing="4" class="parameters">
<tr>
<th>Name</th>
<th>Type</th>
<th>Direction</th>
<th>Required</th>
<th>Default</th>
<th>Description</th>
</tr>
<tr>
<td>value</td>
<td>String</td>
<td>in-out</td>
<td>no</td>
<td>post</td>
<td>The text inside the textarea. The parameter is only updated
when the the Text component is not disabled.
</td>
</tr>
<tr>
<td>disabled</td>
<td>boolean</td>
<td>in</td>
<td>no</td>
<td>false</td>
<td>Controls whether the textarea is active or not. If disabled, then
any value that comes up when the form is submitted is ignored.
Corresponds to the "disabled" HTML attribute.</td>
</tr>
</table><BR>Body:
<STRONG>removed</STRONG><BR>Informal parameters:
<STRONG>allowed</STRONG>
<br>
Reserved parameters: "name"
</td>
</tr>
<tr>
<td colspan="2">
<b>Examples</b>
<p>
The Text component is used in this example eto provide a customer comments
feedback &lt;textarea&gt;.
<p>
<table class="tapestry-examples" valign="middle" cellspacing="8">
<tr>
<td>Your Comments</td>
<td><TEXTAREA name=textarea rows=5>Please enter your comments here</TEXTAREA>
</td>
</tr>
<tr align="right">
<td colspan="2"><input type="submit" value="Submit"></td>
</tr>
</table>
<p>
<pre>
&lt;table valign="middle"&gt;
&lt;form jwcid=&quot;@<a href="Form.html">Form</a>&quot; listener="ognl:listeners.formSubmit"&gt;
&lt;tr&gt;
&lt;td&gt;Your Comments&lt;/td&gt;
&lt;td&gt;&lt;textarea jwcid="<span class="jwcid">commentsText</span>" rows="5" cols="20"/&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr align="right"&gt;
&lt;td colspan="2"&gt;&lt;input type="submit" value="Submit"/&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/form&gt;
&lt;/table&gt;
&lt;property-specification name=&quot;comments&quot; type=&quot;java.lang.String&quot; persistent=&quot;yes&quot; initial-value=&quot;'Please enter your comments here'&quot;/&gt;<br>
public class CustomerCommentsPage extends BasePage {
public void formSubmit(IRequestCycle requestCycle) {
// Proccess customer comments
}
}
</pre>
</td>
</tr></table>
</td></tr>
<tr>
<td colspan="3"><hr></td>
</tr>
<tr>
<td align="left"><A href="Submit.html"><IMG alt=Submit src="common-images/prev.png"></A></td>
<td align="middle"><A href="index.html"><IMG alt="Component Index" src="common-images/home.png" ></A></td>
<td align="right"><A href="TextField.html"><IMG alt=TextField src="common-images/next.png"></A></td>
</tr>
</table>
</body>
</html>