C H A P T E R  6

Button

A Button is a type of command field that submits form data. The button's request handling behavior is implemented in an instance-specific request handler method (handle<ComponentName>Request) or delegated to a command 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.

Req

Name

The name of the component instance.

 

Request Handler

Determines what will be the request handling mechanism for the command field. This could be the request event handler method (handle<ComponentName>Request), a custom command component, or a built-in command component, like a WebAction command, for example). The default setting is the request event handler method.

 

Visible

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