Installation
Applying a theme from Theme Gallery to your PrimeFaces project is very easy, you just need to download the theme jar, add it your classpath and configure PrimeFaces to use it.
1) You can either download the theme manually from repository or using maven.
Manual Download
PrimeFaces community themes are bundled as jar files available at PrimeFaces Repository.
Maven Dependencies
|
<dependency> <groupId>org.primefaces.themes</groupId> <artifactId>cupertino</artifactId> <version>1.0.10</version> </dependency> |
All community themes are also available in “all-in-one” package.
|
<dependency> <groupId>org.primefaces.themes</groupId> <artifactId>all-themes</artifactId> <version>1.0.10</version> </dependency> |
2) Next and final step is setting primefaces.THEME parameter with the theme name, note that you can also use an EL expression for dynamic themes.
|
<context-param> <param-name>primefaces.THEME</param-name> <param-value>bootstrap</param-value> </context-param> |
That’s it!
Creating a New Theme
If you want to create a custom theme instead of using the prebuilt ones, easiest way is to use the ThemeRoller which provides a visual tool to create your themes easily without requiring knowledge of CSS. Once you’ve downloaded your custom theme from ThemeRoller, refer to User’s Guide for more information and an example about applying your theme. There is also a 3rd party Theme Converter application as an alternative.
Sharing Themes
If you think your custom theme looks cool and would like to share it with PrimeFaces community, feel free to contact us and we’ll add it to the theme gallery.