Tag Documentation

Description:

A button that invokes a server-side action when clicked by the user. This control must be contained by a standard JavaServer Faces form.

Children

Any. Children are displayed as button label after the content of the value property. Control Parameter children are added as request parameters to the submitted form when the button is clicked.

Component Information
Info	Value
Component Type	`javax.faces.HtmlCommandButton`
Handler Class	None
Renderer Type	`com.webmethods.caf.faces.Button`
Description	Button that executes an action
Palette Location	`CAF Html/Control/Command/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
`image`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Image to display in place of button
`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
`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)
`type`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Button type If not specified, the default value is "submit". Valid values are: submit reset
`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

Command Button - caf_h:commandButton