You can drag the Text Area component
from
the Palette's Basic category to the Visual Designer to provide a text input area
where users can type or paste multiple lines of text. The HTML
equivalent for this component is
<textarea>
.
After dragging the component to the Visual Designer, you can do a number of things with it:
text
property.
You can also bind this property to an object or a field of a database table that can display a value and receive the text typed in by the user.
id
attribute. In the page bean, this property's
value is the name of the TextArea
object.label
property is not as flexible as the Label component. You can use the Label component if you want more control over the label's appearance, such as positioning of the label relative to the component.height
in the style
property. For example, height: 100;
sets the height to 100 pixels.text
property is updated with this text. label
property with this text.
label
property is not as flexible as the Label component. You can use the Label component if you want more control over the label's appearance, such as positioning of the label relative to the component.validate
method so you can insert code to validate the value of the component.processValueChange
method so you can insert code that executes when the value of this component changes (for example, the user changes the value of another component that is controlling the value of this component)common_timeoutSubmitForm(this.form, 'component-id');
. At runtime, this code causes the form to be automatically submitted if the user changes the component value. Once the form is submitted, conversion and validation occur on the server and any value change listener methods execute, and then the page is redisplayed.
A component configured to Auto-Submit on Change can use virtual forms to limit the input fields that are processed when the form is submitted. If the auto-submit component is defined to submit a virtual form, only the participants in that virtual form will be processed when the auto-submit occurs.
text
property to a data provider or an object, as described in the topic Bind to Data Dialog Box. text
property to other objects or bean properties that update this component's properties automatically.