The themeSelect component can be used to dynamically change the currently used ACE ThemeRoller theme in the application. It overrides the initial/default theme set by a context param as detailed in http://www.icesoft.org/wiki/display/ICE/ace.theme, which also describes the location and naming of the theme stylesheet files.
|See the ICEfaces Showcase Live Demo of this component, complete with source code.|
The list will be automatically populated with the supported Themeroller themes found in the application's classpath.
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.
value: the name of the theme as described in the link in the Overview above. Note: the value "none" will have no effect and "sam" will be used.
|| Listener method that will be notified when a new value has been set for this input component.
Client Behavior Events
|| Fired whenever the value of the component changes (default event).
The client side component object is exposed through the global variable name specified in the widgetVar attribute.
var widget = ice.ace.instance('frm:componentId);
|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">).|
Keyboard and ARIA Support
The following ARIA roles are supported: listbox.
The following markup represents the basic HTML structure of the component and the CSS classes it uses.
<span class="ui-select-theme [user defined classes]">
<select class="ui-widget ui-state-default ui-state-optional" style="[user defined styles]">
The theme specified in the org.icefaces.ace.theme context parameter will be used as the theme for the current user, whenever the value of this component is null. If the value of this context parameter is null as well, then the sam theme will be used by default. If the value of this parameter is none, then no theme will be used at all.