Tomahawk Tag Reference - Command Button

Documentation

Search

10. Tomahawk Tag Reference

The t:commandButton tag extends the JSF commandButton tag. It renders an HTML button element.

Example

<t:commandButton></t:commandButton>

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.

actionFor	Text

The actionFor attribute expects a comma-separated list of component IDs associated with the component generating the action event.

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.

enabledOnUserRole	Text

The enabledOnUserRole attribute determines if this component will be rendered normally or not depending on the user's roles.

forceId	Boolean

The forceId attribute expects a boolean value, that when set to true, forces the tag to render its ID exactly as specified in the ID attribute. This allows you to apply CSS styles to the tag and to reference it in JavaScript by ID, which is typically not possible using the default JSF component ID naming system. This attribute is false by default.

forceIdIndex	Text

The forceIdIndex attribute effects the component ID name when this component is rendered at runtime. It expects a boolean value that, when true, causes the component to display an index number in its ID value if the component is in a list. It has a default value of true.

id	Text

The unique identifier value for this component. The value must be unique within the closest naming container.

image	File

The image attribute links a image to the button through a URL.

immediate	Boolean

The immediate attribute is a boolean flag indicating that component events should be sent to registered event listeners immediately rather than after the validation phase of the JSF request processing lifecycle. The immediate flag allows you bypass JSF validation for a particular 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.

ondblclick	Text

The ondblclick attribute sets the JavaScript code to execute 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.

onkeypress	Text

The onkeypress attribute sets the JavaScript code to execute 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.

onmousedown	Text

The onmousedown attribute sets the JavaScript code to execute 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.

onmouseout	Text

The onmouseout attribute sets the JavaScript code to execute 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.

onmouseup	Text

The onmouseup attribute sets the JavaScript code to execute 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.

rendered	Boolean

A value-binding expression that evaluates to a Boolean condition indicating if this component should be rendered.

size	Text

The size attribute sets the width in characters of this input field.

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	Text

The type attribute specifies the HTML content type associated with the resource pointed to by this hyperlink.

value	Text

The value attribute sets the current value for this component.

visibleOnUserRole	Text

The visibleOnUserRole attribute determines if this component will be visible or not depending on the user's roles.