The ace:checkboxButton component is a simple true/false selection used to toggle a value that is bound to the button. As of EE 3.3.0_P02/4.0 release, the buttonGroup component can be used to manage a group of checkboxButton components.
|See the ICEfaces Showcase Live Demo of this component, complete with source code.|
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.
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|
|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.|
The client side component object is exposed through the global variable name specified in the widgetVar attribute.
|The ice.ace.instance function requires the full client id of the component to be specified, such as "j_idt77:componentId" instead of just "componentId". To reduce the complexity of working with complete IDs with this function it may be preferable in some cases to use prependId="false" in the enclosing form (e.g. <h:form prependId="false">).|
Default browser keyboard support for <button> elements (i.e. tabbing in and out, pressing space to activate).
The following ARIA roles are supported: checkbox.
The following markup represents the basic HTML structure of the component and the CSS classes it uses.