Overview | Library | Tag | Help
| FRAMES NO FRAMES

## ICE Components
Tag commandButton

Renders an HTML "input" element.

Decode Behavior

Obtain the `Map` from the "requestParameterMap" property of the `ExternalContext`. If the value in the `Map` for the value of the "clientId" property of the component is `null`, create a String by concatenating the value of the "clientId" property of the component with the String ".x" (without the quotes). Create another String in the same manner, but concatenate ".y" (without the quotes). If `null` is the value in the `Map` for both Strings, return from `decode()`. If the value in the `Map` for the value of the "clientId" property of the component is not `null`, get the value of the "type" attribute, and convert it to lower case. If the result is equal to the String "reset" (without the quotes), return from `decode()`. Otherwise, create a `javax.faces.event.ActionEvent` around the component, and pass it to the `queueEvent()` method of the component, which must be an instance of `UICommand`.

Encode Behavior

Render the clientId of the component as the value of the "name" attribute. Render the current value of the component as the value of the "value" attribute. If the "styleClass" attribute is specified, render its value as the value of the "class" attribute.

Tag Information
Tag Class | com.icesoft.faces.component.CommandButtonTag
TagExtraInfo Class | None
Body Content | JSP
Display Name | None

Attributes
Name | Required | Request-time | Type | Description
accesskey | false | false | `java.lang.String` | Access key that, when pressed, transfers focus to this element.
action | false | false | `java.lang.String` | MethodBinding representing the application action to invoke when this component is activated by the user. The expression must evaluate to a either a String or a public method that takes no parameters, and returns a String (the logical outcome) which is passed to the NavigationHandler for this application.
actionListener | false | false | `java.lang.String` | MethodBinding 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.
alt | false | false | `java.lang.String` | Alternate textual description of the element rendered by this component.
binding | false | false | `java.lang.String` | The value binding expression linking this component to a property in a backing bean
dir | false | false | `java.lang.String` | Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).
disabled | false | false | `java.lang.String` | Flag indicating that this element must never receive focus or be included in a subsequent submit.
effect | false | false | `java.lang.String` | The Javascript Effect
enabledOnUserRole | false | false | `java.lang.String` | If user is in given role, this component will be rendered normally. If not, the component will be in disabled state.
id | false | false | `java.lang.String` | The component identifier for this component. This value must be unique within the closest parent component that is a naming container.
image | false | false | `java.lang.String` | Absolute 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.
immediate | false | false | `java.lang.String` | Flag indicating that this component's value must be converted and validated immediately (that is, during Apply Request Values phase), rather than waiting until Process Validations phase.
label | false | false | `java.lang.String` | A localized user presentable name for this component.
lang | false | false | `java.lang.String` | Code describing the language used in the generated markup for this component.
onblur | false | false | `java.lang.String` | Javascript code executed when this element loses focus.
onchange | false | false | `java.lang.String` | Javascript code executed when this element loses focus and its value has been modified since gaining focus.
onclick | false | false | `java.lang.String` | No Description
onclickeffect | false | false | `java.lang.String` | Effect invoked on onclick event
ondblclick | false | false | `java.lang.String` | No Description
ondblclickeffect | false | false | `java.lang.String` | Effect invoked on ondblclick event
onfocus | false | false | `java.lang.String` | Javascript code executed when this element receives focus.
onkeydown | false | false | `java.lang.String` | No Description
onkeydowneffect | false | false | `java.lang.String` | Effect invoked on onkeydown event
onkeypress | false | false | `java.lang.String` | No Description
onkeypresseffect | false | false | `java.lang.String` | Effect invoked on onkeypress event
onkeyup | false | false | `java.lang.String` | No Description
onkeyupeffect | false | false | `java.lang.String` | Effect invoked on onkeyup event
onmousedown | false | false | `java.lang.String` | No Description
onmousedowneffect | false | false | `java.lang.String` | Effect invoked on onmousedown event
onmousemove | false | false | `java.lang.String` | No Description
onmousemoveeffect | false | false | `java.lang.String` | Effect invoked on onmousemove event
onmouseout | false | false | `java.lang.String` | No Description
onmouseouteffect | false | false | `java.lang.String` | Effect invoked on onmouse event
onmouseover | false | false | `java.lang.String` | No Description
onmouseovereffect | false | false | `java.lang.String` | Effect invoked on onmouseover event
onmouseup | false | false | `java.lang.String` | No Description
onmouseupeffect | false | false | `java.lang.String` | Effect invoked on onmouseup event
onselect | false | false | `java.lang.String` | Javascript code executed when text within this element is selected by the user.
panelConfirmation | false | false | `java.lang.String` | The id of the ice:panelConfirmation component linked to this button.
partialSubmit | false | false | `java.lang.String` | Enable component to perform partial submit. Default value is false.
readonly | false | false | `java.lang.String` | Flag indicating that this component will prohibit changes by the user. The element may receive focus unless it has also been disabled. This attribute is valid for input types "text" and "password" only. It is non-functional for other input types like "radio" or "checkbox".
rendered | false | false | `java.lang.String` | Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit.
renderedOnUserRole | false | false | `java.lang.String` | If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped.
style | false | false | `java.lang.String` | CSS style(s) to be applied when this component is rendered.
styleClass | false | false | `java.lang.String` | The base name for all style classes. Default value is iceCmdBtn if enabled and iceCmdBtn-dis if disabled.
tabindex | false | false | `java.lang.String` | Position of this element in the tabbing order for the current document. This value must be an integer between 0 and 32767.
title | false | false | `java.lang.String` | Advisory title information about markup elements generated for this component.
type | false | false | `java.lang.String` | Type of button to create. Valid values are "submit" and "reset". If not specified, or not a valid value, the default value is "submit".
value | false | false | `java.lang.String` | The current value of this component.
visible | false | false | `java.lang.String` | Set the visibility of this component. When false CSS style is set to display:none

Variables
| No Variables Defined.

Overview | Library | Tag | Help
| FRAMES NO FRAMES

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.