o
Tag commandButton


This is an analog of the standard component extended with Ajax features making it possible to use Ajax request instead of form submission to execute an action and reload components. By default it behaves as its standard analog though Ajax functionality will be turned on if you specify its "render" attribute, which is similar to that of component and specifies the list of components that should be reloaded when the button is clicked. An additional optional attribute is "execute", which just like in the component allows specifying a list of components whose data should be submitted to the server for processing during the Ajax request.


Tag Information
Tag Classorg.openfaces.taglib.jsp.command.CommandButtonJspTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredBinding TypeELDefaultDescription
accesskeyfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullAn access key for the component.
actionfalsejavax.el.MethodExpression
(signature must match java.lang.Object action())
truenullSimilar to the "action" attribute of the HTMLCommandButton component. It can be defined as a MethodBinding that should point to an action method that is called when the user clicks this button.
actionListenerfalsejavax.el.MethodExpression
(signature must match void actionListener(javax.faces.event.ActionEvent))
truenullSimilar to the "actionListener" attribute of the HTMLCommandButton component. A MethodBinding that should point to an action listener that is called when the user invokes this action.
altfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullAlternate textual description of the element rendered by this component.
bindingfalsejavax.el.ValueExpression
(must evaluate to org.openfaces.component.command.CommandButton)
onlynullA value-binding expression that associates the CommandButton with a backing bean property.
dirfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullThe base direction of directionally neutral text. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).
disabledfalsejavax.el.ValueExpression
(must evaluate to boolean)
truefalseA flag that enables or disables the component.
executefalsejavax.el.ValueExpression
(must evaluate to java.util.List)
truenoneId's of components whose data should be submitted and processed on the server in addition to the reloaded components. The difference with render is that components listed in execute will just process the submitted data, but won't be rerendered. This can often be needed when the reloaded data depends on some other component on a page. Evaluates to Iterable. If a literal is specified can be a single id or a comma-separated list if id's.
idfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
falsenullThe component identifier.
imagefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullAbsolute or relative URL of the image to be displayed for this button. If specified, this "input" element will be of type "image". Otherwise, it will be of the type specified by the "type" property with a label specified by the "value" property. If there are child components inside of the tag, the "image" attribute's value will be ignored and child components will be displayed as the button's content.
immediatefalsejavax.el.ValueExpression
(must evaluate to boolean)
truefalseA flag that indicates whether or not actionListener should be executed immediately (during the Apply Request Values phase of the request processing lifecycle instead of Process Validations phase).
langfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullLanguage code for this component. Rendered as the HTML lang attribute.
onblurfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the component loses focus.
onclickfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed on the client when the user clicks the left mouse button over the component.
oncontextmenufalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user presses right mouse button over the component (or performs the other context menu invocation action depending on the platform).
ondblclickfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed on the client when the user double-clicks the left mouse button over the component.
onfocusfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the component receives focus.
onkeydownfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user presses a key over the component.
onkeypressfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed on the client when the user presses and releases a key over the component.
onkeyupfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user releases a key over the component.
onmousedownfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user clicks over the component with either mouse button.
onmousedownfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user clicks over the component with either mouse button.
onmousemovefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user moves the mouse pointer over the component.
onmouseoutfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user moves the mouse pointer away from the component.
onmouseoverfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user moves the mouse pointer onto the component.
onmouseupfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user releases the mouse button over the component.
renderfalsejavax.el.ValueExpression
(must evaluate to java.util.List)
truenoneId's of components, which will be rerendered after successful Ajax request. Evaluates to Iterable. If a literal is specified can be a single id or a comma-separated list if id's.
renderedfalsejavax.el.ValueExpression
(must evaluate to boolean)
truefalseA flag that indicates whether or not the component is visible.
stylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the CommandButton component.
styleClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the InputText component.
tabindexfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullPosition of the component in the focus transition chain for the current document.
titlefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullAn advisory title for the text field of this filter component.
typefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"submit"Input type string for the rendered tag. Can be "submit", "reset", or "button".
valuefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullThe text displayed in the button.

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.