blob: c845c4659c4e97d3e841e1bea4a733b2b47ba5bc [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright 2004, 2005 The Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<title>TextArea</title>
</properties>
<body>
<section name="TextArea">
<p>
A form element control that renders an HTML <code>&lt;textarea&gt;</code>, a multi-line text
input.
</p>
<p>
<strong>
See also:
<a href="../../apidocs/org/apache/tapestry/form/TextArea.html">
org.apache.tapestry.form.TextArea
</a>
,
<a href="../general/inserttext.html">InsertText</a>
,
<a href="textfield.html">TextField</a>
</strong>
</p>
<section name="Parameters">
<table>
<tr>
<th>Name</th>
<th>Type</th>
<th>Required</th>
<th>Default</th>
<th>Description</th>
</tr>
<tr>
<td>value</td>
<td>string</td>
<td>yes</td>
<td></td>
<td>
The value to read and update (unless the disabled parameters is true).
</td>
</tr>
<tr>
<td>disabled</td>
<td>boolean</td>
<td>no</td>
<td>false</td>
<td>
If true, then the <code>&lt;textarea&gt;</code> will be written with a disabled
attribute (preventing user interaction in the client web browser). In
addition, when the form is submitted, the component will not update its
value parameter.
</td>
</tr>
<tr>
<td>displayName</td>
<td>string</td>
<td>no</td>
<td></td>
<td>
A name for the field, which may be used by the
<a href="fieldlabel.html">FieldLabel</a>
component connected to the TextArea.
</td>
</tr>
<tr>
<td>validators</td>
<td>
Array or collection of
<a
href="../../apidocs/org/apache/tapestry/form/validator/Validator.html">
Validator
</a>
</td>
<td>no</td>
<td></td>
<td>
The validators to apply to the component. Something along the lines of:
<code>validators:required</code> .<br/><br/>
<strong>See also:</strong> <a href="../../usersguide/validation.html">Validation</a>
</td>
</tr>
<tr>
<td>translator</td>
<td>
<a
href="../../tapestry/apidocs/org/apache/tapestry/form/translator/Translator.html">
Translator
</a>
</td>
<td>no</td>
<td></td>
<td>
The translator to use when displaying and parsing the date.
<br/><br/>
<strong>See also:</strong> <a href="../../usersguide/validation.html">Validation</a>
</td>
</tr>
</table>
<p>
Body:
<strong>removed</strong>
</p>
<p>
Informal parameters:
<strong>allowed</strong>
</p>
<p>Reserved parameters: name</p>
</section>
</section>
</body>
</document>