View Source

h2. Overview

The _ace:pushButton_ component allows submission of a form in it's entirety or also the submission of itself only. This component supports an action attribute as well as an _actionListener_ attribute similar to a _h:commandButton_.

h2. Getting Started
{panel}
{code:xml|borderStyle=dashed}
<html ... xmlns:ace="http://www.icefaces.org/icefaces/components">

<h:body>
<h:form >
<h:panelGroup id="push1">
<ace:pushButton
id="pushId"
value="submit"
label="this button submits the entire form"
actionListener="#{button.actionListenerMethod}" />
</h:panelGroup>
</h:form>
</h:body>
{code}
{panel}
h2. Attributes

{tip:title=TagLib Documentation}This section covers attributes involved in the typical use-cases for this component. For reference, the complete taglib documentation for this component is available [here|http://www.icefaces.org/docs/v3_latest/ace/tld/ace/pushButton.html].{tip}
{panel}
*value* refers to the text written on the button, similar to that of jsf commandButton.
{panel}
{panel}
*label* If no value present, the label will be used for the pushButton. Otherwise if both are used, the label will be used to define the aria-role, described-by.

{panel}
{panel}
*style:* a pass through to the root element of the component.
{panel}
{panel}
*styleClass* a pass through to the root element of the component.
{panel}
{panel}
*tabindex* a pass through to the root element of the component, default=0.
{panel}
{panel}
*disabled* a pass through to the root element of the component.
{panel}
{panel}
The following attributes are supported as pass-thru attributes: *accesskey*, *alt*, *dir*, *label*, *lang*, *style*, *tabindex*, *title*, *type*, *onchange*, *onselect*, *onclick*, *ondblclick*, *onkeydown*, *onkeypress*, *onkeyup*, *onmousedown*, *onmousemove*, *onmouseout*, *onmouseover*, *onmouseup*, *onblur*, *onfocus*
{panel}

h2. Event Listeners

As a descendant of UICommand, this component supports an action listener.

| actionListener | Method that will be notified when the component is activated by the user |

h2. Client Behavior Events

| action | Fired when the button is clicked or pressed by any other means (default event). |

{tip}Prior to 4.0 this event was named "activate". The "activate" event name is now deprecated but treated as an alias for "action" for backwards compatibility with existing applications.{tip}

h2. JavaScript API

None.

h2. Keyboard Support

None.

h2. CSS Classes

The following markup represents the basic HTML structure of the component and the CSS classes it uses.

{code:xml}
<div class="yui-content ui-tabs-panel ui-widget-content ui-corner-bottom">
<div>
<div class="ui-tabs-panel ui-widget-content ui-corner-bottom">
<div class="[user defined classes]" style="[user defined styles]">
<span class="first-child">
<button class="ui-button ui-widget ui-state-default ui-corner-all">
<span>Label</span>
</button>
</span>
</div>
</div>
</div>
</div>
{code}

h2. Known Issues

None.

h2. Additional Resources

None.