C H A P T E R  23

Validating Text Area

The Validating Text Area component is a multi-line, free-form text input field with the ability to validate the user-supplied text using an associated validation component.

Property Name

Description

Notes

Initial Value

The value to which the visual component is initialized upon its instantiation. Note, this value will overwrite any value in the bound model field if one exists. If you want to set a value on a component without potentially overwriting the model field's value, avoid using this property and instead use the setValue(Object value,boolean overwrite) method with the overwrite parameter set to false. You may call this method from your code as needed (for example, from an event handler) or from the Post-initialization Code property of the component.

 

Model Field Binding

The model field to which the visual component is bound (where it stores/retrieves its value). The Model Reference property must be configured before this property can be configured.

Dependent on Model Reference

Model Reference

A reference to the model to which the visual component's bound model field belongs. This property must be configured before the Model Field Binding property can be configured.

 

Name

The name of the component instance.

Req

Show Validation Failure Message

Determines whether to show the value of the Validation Failure Message property when validation fails for the component.

 

Validation Failure Message

The text message to optionally display to the end user when validation fails for the field. This value may contain markup.

 

Validator

The validation component associated with the field.

 

Visible

Controls whether the component will be displayed or not. Can also be set programmatically using the component's setVisible(boolean) method.