From richfaces-svn-commits at lists.jboss.org Thu Aug  2 09:49:34 2007
Content-Type: multipart/mixed; boundary="===============6997555743125368274=="
MIME-Version: 1.0
From: richfaces-svn-commits at lists.jboss.org
To: richfaces-svn-commits at lists.jboss.org
Subject: [richfaces-svn-commits] JBoss Rich Faces SVN: r2011 -
 trunk/docs/userguide/en/src/main/docbook/modules.
Date: Thu, 02 Aug 2007 09:49:34 -0400
Message-ID: <E1IGb3W-0006XD-Hv@committer01.frg.pub.inap.atl.jboss.com>

--===============6997555743125368274==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: smukhina
Date: 2007-08-02 09:49:34 -0400 (Thu, 02 Aug 2007)
New Revision: 2011

Added:
   trunk/docs/userguide/en/src/main/docbook/modules/a4jUGskinnability.xml
Log:
http://jira.jboss.com/jira/browse/RF-522
Guides chapters merging

Added: trunk/docs/userguide/en/src/main/docbook/modules/a4jUGskinnability.x=
ml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/userguide/en/src/main/docbook/modules/a4jUGskinnability.xml	=
                        (rev 0)
+++ trunk/docs/userguide/en/src/main/docbook/modules/a4jUGskinnability.xml	=
2007-08-02 13:49:34 UTC (rev 2011)
@@ -0,0 +1,79 @@
+<?xml version=3D'1.0' encoding=3D'UTF-8'?>
+<chapter id=3D"Built-inSkinnabilityInAjax4jsf"  xreflabel=3D"Built-inSkinn=
abilityInAjax4jsf">
+  <?dbhtml filename=3D"Built-inSkinnabilityInAjax4jsf.html"?>
+
+  <chapterinfo>
+    <keywordset>
+      <keyword>Skinnability</keyword>
+
+      <keyword>skins</keyword>
+
+      <keyword>custom skin</keyword>
+    </keywordset>
+  </chapterinfo>
+
+  <title>Built-in skinnability in Ajax4jsf</title>
+  <para>Ajax4jsf gives an opportunity to incorporate <property>skinnabilit=
y</property> into UI
+  design. With this framework you can easily use named skin parameters in
+  properties files to control the appearance of the skins that are applied
+  consistently to a whole set of components. You can look at examples of
+  predefined skins at:</para>
+  <simplelist>
+    <member>
+      <ulink url=3D"http://livedemo.exadel.com/richfaces-demo/">http://liv=
edemo.exadel.com/richfaces-demo/</ulink>
+    </member>
+  </simplelist>
+  <para>
+    You may simply control the look-and-feel of your application by using =
the <property>skinnability</property> service =

+    of the Ajax4jsf framework. With the means of this service you can defi=
ne the same style for rendering =

+    standard JSF components and custom JSF components built with the help =
of Ajax4jsf.
+  </para>
+  <para>To find out more on  <property>skinnability</property> possibiliti=
es, follow these
+  steps:</para>
+   <itemizedlist>
+    <listitem>
+      Create a custom render kit and register it in the faces-config.xml
+      like this:
+      <programlisting role=3D"XML"><![CDATA[<render-kit>
+        <render-kit-id>NEW_SKIN</render-kit-id>
+        <render-kit-class> =

+            org.ajax4jsf.framework.renderer.ChameleonRenderKitImpl
+        </render-kit-class>
+</render-kit>]]></programlisting>
+    </listitem>
+    <listitem>
+      Then you need to create and register custom renderers for the
+      component based on the look-and-feel predefined variables:
+      <programlisting role=3D"XML"><![CDATA[<renderer>
+        <component-family>javax.faces.Command</component-family> =

+        <renderer-type>javax.faces.Link</renderer-type> =

+        <renderer-class>
+           newskin.HtmlCommandLinkRenderer
+        </renderer-class> =

+</renderer>]]></programlisting>
+    </listitem>
+    <listitem>
+      Finally, you need to place a properties file with skin parameters
+      into the class path root. There are two requirements for the propert=
ies
+      file:
+      <itemizedlist>
+        <listitem>
+          The file must be named <emphasis role=3D"bold"><property>&lt;ski=
nName&gt;</property></emphasis>.skin.properties, in this case, it would be =
called
+          <filename>newskin.skin.properties</filename>.
+        </listitem>
+        <listitem>
+          The first line in this file should be render.kit=3D
+          <emphasis role=3D"bold"><property>&lt;render-kit-id&gt;</propert=
y>,</emphasis> in this case, it would be called
+          render.kit=3DNEW_SKIN.
+        </listitem>
+      </itemizedlist>
+    </listitem>
+   </itemizedlist>
+  <para>Extra information on custom renderers creation can be found
+  at:</para>
+  <simplelist>
+    <member>
+      <ulink url=3D"http://java.sun.com/javaee/javaserverfaces/reference/d=
ocs/index.html">http://java.sun.com/javaee/javaserverfaces/reference/docs/i=
ndex.html</ulink>
+    </member>
+  </simplelist>
+</chapter>


--===============6997555743125368274==--