Introduction

• Struts-Layout skins are configured using a properties file. The configurable properties includes the css file name, the image directory, the names of HTML renderers and much more.
• Struts-Layouts ships with a default properties file, so you don't need to do anything to get a working configuration. However, you will certainly like to use your own CSS file. To add additional skins put additional properties files named "Struts-Layout_<skin name>.properties" in your WEB-INF/classes directory.
• To associate a skin to an HTTP session, use the static method setSkin(HttpSession session, String skinName) in fr.improve.struts.taglib.layout.util.LayoutUtil.
• To set the default skin configuration, name the configuration file "Struts-Layout_default.properties".
• If you don't want your skin configuration files to start with "Struts-Layout" you can set another prefix by using the Struts-Layout plugin.

Configuration properties

Using several collection implementation in the same skin:

To use several collection renderer with the same skin, it is possible to add a model name after the property. For example, collection.class.myModel = com.foo.MyCollectionInterface declares a new collection renderer that can be used by setting the model attribute of the collection tag to "myModel".

Using several field implementation in the same skin:

To use several field renderer with the same skin, it is possible to add a model name after the property. For example, field.class.myModel = com.foo.MyFieldInterface declares a new field renderer that can be used by setting the model attribute of the input field tags to "myModel".

Setting default styleClass

To set default value to the styleClass attributes, the following can bed added to the skin configuration file:

• styleclass.collection = COLLECTION
• styleclass.panel = PANEL
• styleclass.label = FIELD
• styleclass.grid = GRID
• styleclass.pager = PAGER
• styleclass.layer = LAYER

Plugin configuration example

To use a different default configuration file, the struts-layout plugin must be initialized. This is done by adding the following code in struts-config.xml:

			 <plug-in className="fr.improve.struts.taglib.layout.workflow.LayoutPlugin">
			 	<set-property property="skinResources" value="MyDefaultSkin"/>
			 </plug-in>
			

If you're using struts 1.0, plugin extension is not available, and you will need to subclass the struts ActionServlet and add the following code in the init method.

fr.improve.struts.taglib.layout.skin.Skin.setResourcesName("MyDefaultSkin");