OverviewSince 4.0 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.
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
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 ListenersAs a descendant of UIInput, this component supports a value change listener.
Client Behavior Events
JavaScript APIICEfaces 3.xThe client side component object is exposed through the global variable name specified in the widgetVar attribute. ICEfaces 4+The "widgetVar" attribute on the ACE components has been removed in ICEfaces 4 and in its place a new "ice.ace.instance()" client JavaScript object lookup API has been introduced. The reason for this change is to enable lazy-initialization of the ACE component JavaScript objects to improve runtime performance and reduce browser memory use. var widget = ice.ace.instance('frm:componentId);
Keyboard SupportDefault browser keyboard support for <button> elements (i.e. tabbing in and out, pressing space to activate). The following ARIA roles are supported: radio. CSS ClassesThe 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 IssuesNone. Additional ResourcesNone. |
RadioButton
© Copyright 2021 ICEsoft Technologies Canada Corp.