You are viewing an old version (v. 10) of this page.
<< View previous version | view page history | view next version >>
Overview
The ace:radioButton component is a simple true/false selection used to toggle a value that is bound to the button. This component is available since release 3.3.0_P02. The buttonGroup component may be used to manage a group of radioButton components.
 | See the ICEfaces Showcase Live Demo of this component, complete with source code. |
Getting Started
<html ... xmlns:ace="http://www.icefaces.org/icefaces/components"> <h:body > <h:form> <ace:radioButton value="{button.checked}" label="radioButton"/> </h:form> </h:body> </html>
Attributes
| 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. |
label The label of the button-what the user sees that relates to that particular button. For example, "Remember Me"
labelPosition Position of label relative to the radio button. Supported values are "left/right/top/bottom/none". Default is "none".
group ID of button group component if this button is outside of the button group but wants to logically belong to the group.
style a pass through to the root element of the component.
styleClass a pass through to the root element of the component.
tabindex a pass through to the root element of the component, default=0.
disabled a pass through to the root element of the component.
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
Event Listeners
As a descendant of UIInput, this component supports a value change listener.
| valueChangeListener | Method that will be notified when a new value has been set for this component |
Client Behavior Events
| action | Fired when the button is clicked or pressed by any other means (default event). |
| 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. |
JavaScript API
None.
Keyboard Support
Default browser keyboard support for <button> elements (i.e. tabbing in and out, pressing space to activate).
CSS Classes
The following markup represents the basic HTML structure of the component and the CSS classes it uses.
<!-- Root container --> <div class="ice-ace-radiobutton [user defined classes]" style="[user defined styles]"> <span class="ice-ace-radiobutton-main"> <span> <button class="ui-corner-all ice-ace-radiobutton-selected"> <!-- Icon --> <span class="fa fa-dot-circle-o fa-lg"></span> </button> </span> </span> </div>
Known Issues
None.
Additional Resources
None.