| |
|
|
|
 |
Home NewsProducts Download Buy Now Documentation Support |
 |
 |
|
|
 |
| |
Contents
|
10. ICEfaces Tag Reference
Contents > ICEfaces Tag Reference > ice:commandButton
ice:commandButton |
|
The ice:commandButton tag displays a button which can be linked to an action in a backing bean method by specifying the bean and the method in the actionListener attribute. The button can be replaced by an image by specifying the URL of the image in the image attribute.
Example
<ice:commandButton type="submit" value="Check Out" />
Rendered Output
|
Tag Attributes
| accesskey |
Text |
| |
| The accesskey attribute is a standard HTML attribute that sets the access key that transfers focus to this element when pressed.
|
| action |
Text |
| |
| The action attribute accepts a method-binding expression for a backing bean action method to invoke when this component is activated by the user. An action method must be a public method with no parameters that returns a String. The returned string represents the logical outcome of the action (eg. "success", "failure", etc.) and is used by the JavaServer Faces MVC framework to determine which view to display next.
|
| actionListener |
Text |
| |
| The actionListener attribute accepts a method-binding expression for a backing bean action listener method that will be notified when this component is activated by the user. An action listener method must be a public method with an javax.faces.event.ActionEvent parameter and a void return type.
|
| alt |
Text |
| |
| The alt attribute is a standard HTML attribute that sets the alternate textual description rendered by this component.
|
| binding |
Expression |
| |
| The value-binding expression linking this component tag to a backing bean property.
|
| dir |
Enumerated |
| |
| The dir attribute is a standard HTML attribute that overrides the default text directionality for this component. The values accepted for this component are "LTR" (left-to-right) and "RTL" (right-to-left).
|
| disabled |
Boolean |
| |
| The disabled attribute is a boolean flag that when set to true indicates that this component should not receive focus or be included in a form submit.
|
| effect |
Text |
| |
| The effect attribute specifies the backing bean and method to create an effect with the component. The possible effects are highlight, appear, fade, move and pulsate. For example, create an Effect instance variable in the backing bean and assign newHighlight() to this variable.
|
| enabledOnUserRole |
Boolean |
| |
| The enabledOnUserRole attribute is a boolean flag that when set to "true" and if a role has been configured for the user, then the component will be displayed and will function. If the user does not have a role, then the component will be disabled (will not function) and will be grayed out. |
| id |
Text |
| |
| The unique identifier value for this component. The value must be unique within the closest naming container.
|
| image |
File |
| |
| The image attribute sets the URL of an image to be displayed on this component.
|
| lang |
Text |
| |
| The lang attribute is a standard HTML attribute that sets the code describing the language to be used in the markup generated by this component.
|
| onblur |
Text |
| |
| The onblur attribute sets the JavaScript code to execute when this element loses focus.
|
| onchange |
Text |
| |
| The onchange attribute sets the JavaScript code to execute when this element loses focus and its value changes after gaining focus.
|
| onclick |
Text |
| |
| The onclick attribute sets the JavaScript code to execute when the mouse pointer is clicked over this element.
|
| onclickeffect |
Text |
| |
| The onclickeffect attribute sets the effect to invoke when when the mouse pointer is clicked over this element. |
| ondblclick |
Text |
| |
| The ondblclick attribute sets the JavaScript code to execute when the mouse pointer is double-clicked over this element.
|
| ondblclickeffect |
Text |
| |
| The ondblclickeffect attribute sets the effect to invoke when the mouse pointer is double-clicked over this element. |
| onfocus |
Text |
| |
| The onfocus attribute sets the JavaScript code to execute when the element receives focus.
|
| onkeydown |
Text |
| |
| The onkeydown attribute sets the JavaScript code to execute when a key is pressed down over this element.
|
| onkeydowneffect |
Text |
| |
| The onkeydowneffect attribute sets the effect to invoke when a key is pressed down over this element. |
| onkeypress |
Text |
| |
| The onkeypress attribute sets the JavaScript code to execute when a key is pressed and released over this element.
|
| onkeypresseffect |
Text |
| |
| The onkeypresseffect attribute sets the effect to invoke when a key is pressed and released over this element.
|
| onkeyup |
Text |
| |
| The onkeyup attribute sets the JavaScript code to execute when a key is released over this element.
|
| onkeyupeffect |
Text |
| |
| The onkeyupeffect attribute sets the effect to invoke when a key is released over this element.
|
| onmousedown |
Text |
| |
| The onmousedown attribute sets the JavaScript code to execute when the mouse pointer is pressed down over this element.
|
| onmousedowneffect |
Text |
| |
| The onmousedowneffect attribute sets the effect to invoke when the mouse pointer is pressed down over this element. |
| onmousemove |
Text |
| |
| The onmousemove attribute sets the JavaScript code to execute when the mouse pointer is moved within this element.
|
| onmousemoveeffect |
Text |
| |
| The onmousemoveeffect attribute sets the effect to invoke when the mouse pointer is moved within this element.
|
| onmouseout |
Text |
| |
| The onmouseout attribute sets the JavaScript code to execute when the mouse pointer is moved away from this element.
|
| onmouseouteffect |
Text |
| |
| The onmouseouteffect attribute sets the effect to invoke when the mouse pointer is moved away from this element.
|
| onmouseover |
Text |
| |
| The onmouseover attribute sets the JavaScript code to execute when the mouse pointer is moved onto this element.
|
| onmouseovereffect |
Text |
| |
| The onmouseovereffect attribute sets the effect to invoke when the mouse pointer is moved onto this element.
|
| onmouseup |
Text |
| |
| The onmouseup attribute sets the JavaScript code to execute when the mouse button is released over this element.
|
| onmouseupeffect |
Text |
| |
| The onmouseupeffect attribute sets the effect to invoke when the mouse button is released over this element. |
| onselect |
Text |
| |
| The onselect attribute sets the JavaScript code to execute when the user selects the text contained by this element.
|
| partialSubmit |
Boolean |
| |
| The partialSubmit attribute is a boolean flag that when set to "true" will allow the component to activate a partial submit of the form. |
| readonly |
Boolean |
| |
| The readonly attribute is a boolean flag that when set to true prohibits changes to this element by the user. The element will continue to receive focus unless you set the disabled attribute to true.
|
| rendered |
Boolean |
| |
| A value-binding expression that evaluates to a Boolean condition indicating if this component should be rendered.
|
| renderedOnUserRole |
Text |
| |
| The renderedOnUserRole attribute is a boolean flag that when set to "true" and if a role has been configured for the user, then the component will be displayed. If the user does not have a role, then the component will not be displayed. |
| style |
CSS Style |
| |
| The style attribute sets the CSS style definition to be applied to this component when it is rendered.
|
| styleClass |
CSS Class |
| |
| The styleClass attribute sets the CSS class to apply to this component when it is rendered.
|
| tabindex |
Text |
| |
| The tabindex attribute is a standard HTML attribute that sets the order in which this element receives focus when the user cycles through the elements using the TAB key. The value for this attribute must be an integer between 0 and 32767.
|
| title |
Text |
| |
| The title attribute is a standard HTML attribute that sets the tooltip text to display for the rendered component.
|
| type |
Enumerated |
| |
| The type attribute sets the type of button to display. Valid values are "submit" and "reset". The default is "submit". |
| value |
Text |
| |
| The value attribute sets the current value for this component.
|
| visible |
Boolean |
| |
| The visible attribute is a boolean flag that when set to "true", displays the component. If this attribute is set to "false", then the CSS style is display:none. |
|
|
|
| |
|