
<< View previous version | view page history | view next version >>
PushButton:
page should look like:
<html xmlns:ice="http://www.icefaces.org/icefaces/components" ..> <!-- can use either class of ice-skin-sam or ice-skin-rime --> <h:body class="ice-skin-sam"> <h:form > <ice:pushbutton /> <h:form> <h:body> <html>
basic attributes:
actionListener, example:-
<h:form id="myform"> <h:panelGroup id="push1"> <ice:pushbutton id="pushId" label="submitForm" actionListener="#{button.actionListenerMethod}" /> </h:panelGroup> </h:form>
image and action
<h:form id="myform2"> <h:panelGroup id="push2"> <ice:pushbutton id="pushId2" label="Action" singleSubmit="true" action="#{button.methodAction}" /> </h:panelGroup> </h:form>
Additional attributes:
Defining style:
a pass through to the root element of the component.
Defining style class:
a pass through to the root element of the component.
Defining tabindex:
a pass through to the root element of the component, default=0.
Defining disabled:
a pass through to the root element of the component.
Defining the submission behaviour:
When singleSubmit attribute is true, the pushbutton only submits an event request a submit call with execute=@this and render=@all, if false then full form submit happens where execute being set to @all. default valid is false.
Keyboard and ARIA support:
Pushbutton component supports keyboard short-cuts and ARIA. Aria support can be enabled at page level or at application level. By default ARIA is enabled at application level.
To enable/disable ARIA at page level, the ice:config tag handler can used:
<ice:config ariaEnabled="true"/>
To enable/disable ARIA at application level, the following param can be set in web.xml.
<context-param> <param-name>org.icefaces.aria.enabled</param-name> <param-value>false</param-value> </context-param>
Keyboard short-cuts supported by pushbutton:
- space or enter key will fire the button's onclick event
Aria role="button", aria-describedby and aria-disabled properties supported
Storyboard
Action | focus | hover | active | disabled | onkeypress | aria |
---|---|---|---|---|---|---|
yui-class | yui-button-focus | yui-button-hover | yui-button-active | yui-button-disabled | space or enter will submit | role, disabled, description |
Submit | submit form & queus event | none | submit form/queue event | |||
Single Submit | submit button only & queue event | none | submit form/queue event | |||
Action | ||||||
ActionListener | ||||||
Screen Reader | description | description | role & description | role |