The ACE Components support the jQuery ThemeRoller theming system for component appearance. This system supports a comprehensive CSS-based component theming solution, including tools for creating custom ThemeRoller themes, and a large number of pre-defined themes to choose from.
The ACE Components library (icefaces-ace.jar) includes the following two themes:
In addition, the ICEfaces release bundle includes a large set of additional pre-defined ThemeRoller themes that have been converted for use with the ACE Components. Each theme is provided in its own .jar library file, and can be found in the following directory:
[icefaces.dir]/icefaces/samples/ace/themes/
By default, ICEfaces will automatically load the "sam" theme on each page configured to use the ACE Components.
To configure ICEfaces to use an alternate theme, follow these steps:
<context-param>
<param-name>org.icefaces.ace.theme</param-name>
<param-value>cupertino</param-value>
</context-param>
If you would like to disable the automatic theme loading feature set the org.icefaces.ace.theme context param to none, as illustrated below:
<context-param>
<param-name>org.icefaces.ace.theme</param-name>
<param-value>none</param-value>
</context-param>
Disabling the automatic theme loading feature may be useful in cases where you would like complete control over all CSS being loaded in each page. As an alternative to the automatic theme loading approach, each page can load the styling resources with regular
<link>tags or<h:outputStylesheet>components. Disabling the automatic theme loading feature also disables ACE's custom<h:head>renderer, in which case the default<h:head>renderer or another JSF library custom<h:head>renderer will be used.