You see the Properties window for a Text Area component when you select the component on a page that you are editing in the Visual Designer.
Most of the Text Area component's properties are both JSP attributes and properties of the TextArea
Java component in the page bean.
This component has the following properties.
Type: String
Type: int
columns
property to set the width of the component when the label
property is set. Otherwise you can use the style
or styleClass
property, which overrides the columns
property if the label
property is blank. You can also drag the resize handles to set the component's height and width in the style
property. Type: String
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. Type: int
Type: int
style
or styleClass
property, this property determines the height of the component. If the label
property is not set, the style
or styleClass
property setting overrides the rows
property. Dragging the resize handles sets the component's height and width in the style
property.
height
in the style
property. For example, height: 100;
sets the height to 100 pixels. Type: String
For a list of CSS2 style attributes, see the web page at
Type: String
style
property description for an explanation of why a class added to this property might appear to have no effect on the component. The defaulttheme CSS style classes for this component are:
css_master.css .TxtAra {} .TxtAraDis {background-color:#E1E4E5;color:#848687} .TxtAra, .TxtAraDis {padding-left:2px}
Type: Object
Type: Converter
text
property. The component will pick the correct converter for the text
property if one is available, making it unnecessary to set this property in most cases. If the text
property is bound to a value whose type is not on the list of converters, you have to supply your own converter and set this property. Type: boolean
for
property to this component, an error message will be displayed if the user tries to submit the page without entering a value. Type: MethodBinding
(null)
, no validator is called. If you choose a validator, also select the required
property to ensure that the validator is used.
Set the event properties by right-clicking the component in the Visual Designer and choosing Edit Event Handler > eventname.
validator
property, right-click the component and choose Edit Event Handler > validate. The default name for the method is component-id_validate
, where component-id is the value of the component's id
property. When you define this method in this way, the validator
and validate
properties are automatically set for you. If you define a validator, also select the required
property to ensure that the validator is used.
validator
property. If you define your own validate method, do not separately change the value of the validator
property, or you could lose the connection to your validate method.component-id_processValueChange
, where component-id is the value of the id
property. Type: boolean
readOnly
property concerning the effects of using the disabled
property versus the effects of using the readOnly
property. Type: boolean
disabled
property, JavaServer Faces does not detect that any value at all was submitted. Type: String
title
attribute of the component, which is readable by a screen reader and can be displayed as a tool tip.
Type: boolean
Type: boolean
rendered
property. Type: String
tabindex
attribute of the HTML <input>
tag. Type: String
Type: String
Type: String
Type: String
Type: String
Type: String
Type: String
Type: String
Type: String
Type: String
Type: String
Type: String
Type: String
Type: String
Type: boolean
The most common example of an immediate action is a Cancel button. You make it immediate so that the normal validation and update steps can be skipped, but the action handler can still do whatever is necessary. Typically, the action handler will navigate back to some previous page. In some designs the action handler might also enqueue an informational message like "Transaction cancelled". It is possible to do more: for example, an application might record the fact that the user cancelled the current operation.
Type: boolean
Type: MethodBinding
valueChange
property above, which provides an easier way to set this property's value. The valueChangeListener
property is the MethodBinding
that underlies the valueChange
event property. The valueChangeListener
property is updated when you set the method for the valueChange
event property.
If you click the ellipsis button next to the valueChange
property, you can use that property's property editor to choose an existing method to bind to, or you can create a new method or unbind an existing method. If you are an expert, instead of using the valueChange
property, you can type a MethodBinding
expression directly into this valueChangeListener
property, for example, if you want to call a method that is not in the page bean.