Tag Documentation

Description:
A button that invokes a server-side action when activated as an asynchronous request. This control must be contained by a standard JavaServer Faces form.

You can download an article and an accompanying code sample describing how to work with the refresh attribute of this control from the Software AG Community website:
- Article: Refreshing Multiple Controls with Async Command Controls in CAF
- Code sample: multi_refresh_sample.zip
Children
Any. Children are displayed as button labels after the content of the value attribute. Control Parameter children are added as request parameters to the submitted form when the button is clicked.

Component Information
Info	Value
Component Type	`com.webmethods.caf.faces.command.async.Button`
Handler Class	None
Renderer Type	`com.webmethods.caf.faces.command.async.Button`
Description	Button that invokes an action via asynchronous request
Palette Location	`CAF Html/Control/Command/Async Command Button`
Client-Side Model	`CAF.Command.Model`

Attributes
Name	Required	Type	Description
`accesskey`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Keyboard shortcut letter
`action`	`false`	`javax.el.MethodExpression` (signature must match `java.lang.String action()`)	Action method binding
`actionListener`	`false`	`javax.el.MethodExpression` (signature must match `void actionListener(javax.faces.event.ActionEvent)`)	Action listener method binding
`dir`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Specifies the directionality of the flow of the content for the current element Valid values are: LTR RTL
`disabled`	`false`	`javax.el.ValueExpression` (must evaluate to `boolean`)	True if control is grayed-out and un-modifiable If not specified, the default value is "false".
`forms`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Id of form to submit (defaults to entire form); separate multiple control ids with commas
`id`	`false`	`java.lang.String`	Control identifier
`immediate`	`false`	`javax.el.ValueExpression` (must evaluate to `boolean`)	True to process action listeners in the Apply Request Values phase; false to process in the Invoke Application phase If not specified, the default value is "false".
`lang`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Specifies the language of the enclosed content
`onblur`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	JavaScript "onblur" event handler
`onclick`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	JavaScript "onclick" event handler
`ondblclick`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	JavaScript "ondblclick" event handler
`onfocus`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	JavaScript "onfocus" event handler
`onkeydown`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	JavaScript "onkeydown" event handler
`onkeypress`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	JavaScript "onkeypress" event handler
`onkeyup`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	JavaScript "onkeyup" event handler
`onmousedown`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	JavaScript "onmousedown" event handler
`onmousemove`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	JavaScript "onmousemove" event handler
`onmouseout`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	JavaScript "onmouseout" event handler
`onmouseover`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	JavaScript "onmouseover" event handler
`onmouseup`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	JavaScript "onmouseup" event handler
`refresh`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Id of control to refresh (defaults to entire form) or "_none" to refresh nothing; separate multiple control ids with commas
`rendered`	`false`	`javax.el.ValueExpression` (must evaluate to `boolean`)	True to render control; false to ignore it If not specified, the default value is "true".
`style`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	HTML "style" attribute value
`styleClass`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	HTML "class" attribute value Valid values are: portlet-font portlet-font-dim portlet-msg-status portlet-msg-info portlet-msg-error portlet-msg-alert portlet-msg-success portlet-section-header portlet-section-body portlet-section-alternate portlet-section-selected portlet-section-subheader portlet-section-footer portlet-section-text portlet-form-label portlet-form-input-field portlet-form-button portlet-icon-label portlet-dlg-icon-label portlet-form-field-label portlet-form-field portlet-menu portlet-menu-item portlet-menu-item-selected portlet-menu-item-hover portlet-menu-item-hover-selected portlet-menu-cascade-item portlet-menu-cascade-item-selected portlet-menu-description portlet-menu-caption [any_other_value]
`tabindex`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Order in tab (key) sequence, from 1 to n. Zero adds control to tab sequence, negative integer removes control.
`title`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	HTML "title" attribute value (often displayed as a tooltip)
`toggle`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Id of control to toggle; separate multiple control ids with commas
`value`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.Object`)	Control value
`width`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Pre-defined button width Valid values are: button2 button3 button4 button5 button6 button7 button8 button9 button10 button12 button14 button16 button18 button20

Async Command Button - caf_h:asyncCommandButton