ICEfaces ACE Components
Tag pushButton


The Push Button is a component that allows entry of a complete form or just itself. It has the same functionality of a regular jsf command button but without having to add extra attributes.

For more information, see the PushButton Wiki Documentation.


Client Events
NameDescriptionSupported Classes for ArgumentDefault Event Scopes
actionFired when the button is clicked or pressed by any other means (default event).javax.faces.event.AjaxBehaviorEventexecute=@this render=@all
Client events can be used with Client Behaviors and the ace:ajax tag.


Tag Information
Tag Classorg.icefaces.ace.component.pushbutton.PushButtonTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
accesskeynotruejava.lang.StringAccess key that, when pressed, transfers focus to this component.
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".
altnotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
bindingnotruejavax.el.ValueExpressionUsing an EL expression, bind the component reference to a bean property, so that the component may be accessed in the bean.
dirnotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
disablednotruebooleanIf true, no input may be submitted via this component. 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'.
labelnotruejava.lang.StringA localized user presentable name for this component.
langnotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
offlineDisablednotruebooleanIf true, no input may be submitted via this component when browser is offline. Default = 'false'.
onblurnotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
onchangenotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
onclicknotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
ondblclicknotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
onfocusnotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
onkeydownnotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
onkeypressnotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
onkeyupnotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
onmousedownnotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
onmousemovenotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
onmouseoutnotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
onmouseovernotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
onmouseupnotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
onselectnotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
renderednotruebooleanReturn true if this component (and its children) should be rendered during the Render Response phase of the request processing lifecycle. Default = 'true'.
stylenotruejava.lang.StringThe inline style of the component, rendered on the root div of the component.
styleClassnotruejava.lang.StringThe CSS style class of the component, rendered on the root div of the component.
tabindexnotruejava.lang.IntegerTabindex of the component.
titlenotruejava.lang.StringRenders the provided value as an HTML attribute with the same name on the root element of the component.
typenotruejava.lang.StringSpecifies the button type. The possible values are 'button', 'submit', 'clear' and 'reset'. The 'button' type is the original and standard mode, where the button submits the form when activated. The 'submit' type lets the browser handle the request natively (Note that if the component has a listener or an ajax event attached to it an additional request will be made, handled by ICEfaces, unless the button is activated by pressing the enter key and submitOnEnter is enabled for this component). If the type is 'clear', the component acts in a special way: the button will act in a client-side mode, clearing all fields and components in the form it is contained in. If the type is 'reset', the component will reset all the input elements and components to their original values at the time they were loaded. The button will not submit the form in the 'clear' and 'reset' modes, unless the component has a listener or an ajax event attached to it. 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.