Button

Displays a button. Buttons typically submit the surrounding form, but they can also be defined to run arbitrary JavaScript.

Properties for this display component are:

• buttonTakesName — A boolean value that when set to true, allows the name of the button to be specified. The default is false, which uses a preceding hidden field mechanism for post data. This property is most useful when client javascript affects the button directly.

• class - Specifies the CSS class to use for an enabled button. Defaults to formbutton.

• command– Specifies an optional value to submit along with the name parameter (for example, Save, Cancel, Recalculate).

• confirmDialogAccept — Specifies the text to display on the button that accepts the action on the confirmation dialog. This property is not available on the legacy interfaces.

• confirmDialogCancel — Specifies the text to display on the button that cancels the action on the confirmation dialog. This property is not available on the legacy interfaces.

• confirmDialogText — Specifies the ext that is displayed to the user in a dialog that asks whether to confirm an action. This property is not available on the legacy interfaces.

• disabledclass - Specifies the CSS class to use for a disabled button. Defaults to formbutton.

• formName — Specifies the name of the man form.

• hiddenID– Specifies an optional value for an id parameter to be included in the form post data.

• label– Specifies the visible text that displays on the button.

• link — Causes the button to look like a link when set to true. This properties is for forms that combine links and editable fields on the same page. Because normal links do not post form data, the link behaves like a button.

• linkClass - Specifies the CSS class to use when a button is rendered as a link.

• name– Specifies the name of the parameter that will be posted when the user clicks this button. This property is optional; if not specified, the default value is command.

• nullValue — Indicates the result of getPostData should be null when this value is set to true.

• onMouseOver - Contains the Javascript to execute on an onMouseOver event for the button. You can use this property to change the style of the button when mousing over it.

• onMouseOut - Contains the Javascript to execute on an onMouseOut event for the button. You can use this property to change the style of the button when moving the mouse off it.

• onFocus - Contains the Javascript to execute on an onFocus event for the button. You can use this property to change the style of the button when the button is focused.

• onBlur - Contains the Javascript to execute on an onFocus event for the button. You can use this property to change the style of the button when the button loses focus.

• postURL– Specifies an alternate, target URL to which the form will be posted. This value overrides the URL specified in the JSP.

• submitPreCondition — Provides javascript code to execute prior to submitting. The javascript is expected to return true/false. The submit will occur only if the javascript returns true.

• value– Specifies the value of the parameter posted when the user clicks this button.

• waitDialogText — Specifies the text that is displayed to the user in a dialog after the button is clicked. This property is not available on the legacy interfaces.

Example

<Display class =’Button’>
   <Property name =’label’ value =’Change Password’/>
   <Property name =’value’ value =’Recalculate’/>
</Display>