Mobile Components
Tag commandButton


Renders an HTML "input" element. The component can be styled for the supported mobile device platforms, as well as be used in a group of buttons.
Client Events
NameDescriptionSupported classes for argument
clickFired when commandButton is clicked. javax.faces.event.AjaxBehaviorEvent
Client events can be used with Client Behaviors and the ace:ajax tag.


Tag Information
Tag Classorg.icefaces.mobi.component.button.CommandButtonTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
actionnotruejavax.el.MethodExpressionMethodExpression representing the application action to invoke when this component is activated by the user. The expression must evaluate to a public method that takes no parameters, and returns an Object (the toString() of which is called to derive the logical outcome) which is passed to the NavigationHandler for this application.
actionListenernotruejavax.el.MethodExpressionMethodExpression representing an action listener method that will be notified when this component is activated by the user. The expression must evaluate to a public method that takes an ActionEvent parameter, with a return type of void, or to a public method that takes no arguments with a return type of void. In the latter case, the method has no way of easily knowing where the event came from, but this can be useful in cases where a notification is needed that "some action happened".
bindingnotruejavax.el.ValueExpressionUsing an EL expression, bind the component reference to a bean property, so that the component may be accessed in the bean.
buttonTypenotruejava.lang.StringDetermines the button style. Four styles of buttons are allowed: "important", "back" and "attention", "unimportant", and, if empty or null, "default".
disableOfflinenotruebooleanIf true, default false, the commandButton will disable itself when offline
disablednotruebooleanDisables this component, so it does not receive focus or get submitted. Default = 'false'.
idnotruejava.lang.StringThe component identifier for this component. This value must be unique within the closest parent component that is a naming container.
immediatenotruebooleanFlag indicating that, if this component is activated by the user, notifications should be delivered to interested listeners and actions immediately (that is, during Apply Request Values phase) rather than waiting until Invoke Application phase. Default = 'false'.
onofflinenotruejava.lang.StringJavaScript to be evaluated when the browser goes offline. Two arguments are passed through to the context: the online or offline 'event' argument, and the 'elem' argument for the root element of the component.
ononlinenotruejava.lang.StringJavaScript to be evaluated when the browser goes online. Two arguments are passed through to the context: the online or offline 'event' argument, and the 'elem' argument for the root element of the component.
openContentPanenotruejava.lang.StringThe id of a contentPane in a contentStack that will be displayed when selecting the commandButton.
panelConfirmationnotruejava.lang.StringThe id of panelConfirmation component to be associated with the commandButton.
renderednotruebooleanReturn true if this component (and its children) should be rendered during the Render Response phase of the request processing lifecycle. Default = 'true'.
selectednotruebooleanThe selected state of button. This is normally activated when the commandButton is part of a commandButtonGroup. Default = 'false'.
singleSubmitnotruebooleanWhen singleSubmit is "true", triggering an action on this component will submit and execute only this component only (equivalent to ). When singleSubmit is "false", triggering an action on this component will submit and execute the full form that this component is contained within. Default = 'false'.
stylenotruejava.lang.StringSets the CSS style definition to be applied to this component.
styleClassnotruejava.lang.StringSets the CSS class to apply to this component.
submitNotificationnotruejava.lang.StringThe id of blocking submitNotification panel, which will block UI access to the page until the response has been received.
tabindexnotruejava.lang.IntegerThe tabindex of this component.
typenotruejava.lang.StringThe value of the "type" attribute for the input element, "button", or "submit"The default is "button". Default = 'button'.
valuenotruejava.lang.ObjectThe current value of the simple component.

Variables
No Variables Defined.


Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.