Satya Aravind Kopparthi Weblog

01/04/2009

Cutsomizing RichFaces skins

Filed under: Uncategorized — akopparthi @ 10:53 am

RichFaces comes with the following skins:

* DEFAULT
* plain
* emeraldTown
* blueSky
* wine
* japanCherry
* ruby
* classic
* deepMarine
* NULL

To use a skin, all you need to do is set the name in web.xml file:

org.richfaces.SKIN
ruby

Suppose you like the skin, but you want to make some small changes to it. Here is what to do.

1. Unzip richfaces-impl-3.2.x.GA.jar file. All the skin files are under META-INF/skin
2. Take the skin you want to modify and save it under a different name in resources folder for Maven developers or under class path for others. For example rubycustom.skin.properties
3. Open the file and change the parameter you need. For example

headerBackgroundColor=#FFFFFF

then just set the new skin in web.xml file:

org.richfaces.SKIN
mySkin

Save and restart the server.

Starting with RichFaces 3.2.1, this process has become simpler. You still create a new custom skin file under Java source, and specify which skin to extend:

baseSkin=ruby

this means the skin is based on ruby skin. Next, you just over write the parameter that you need. In this example, it would look like this:

baseSkin=ruby
headerBackgroundColor=#FFFFFF

No Comments Yet »

No comments yet.

RSS feed for comments on this post. TrackBack URI

Leave a comment

Blog at WordPress.com.