[richfaces-svn-commits] JBoss Rich Faces SVN: r12079 - trunk/docs/userguide/en/src/main/docbook/modules.
richfaces-svn-commits at lists.jboss.org
richfaces-svn-commits at lists.jboss.org
Wed Dec 31 04:57:29 EST 2008
Author: atsebro
Date: 2008-12-31 04:57:29 -0500 (Wed, 31 Dec 2008)
New Revision: 12079
Modified:
trunk/docs/userguide/en/src/main/docbook/modules/RFCGettingStarted.xml
Log:
RF-4056: Getting Started with RichFaces chapter should be updated
Modified: trunk/docs/userguide/en/src/main/docbook/modules/RFCGettingStarted.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/modules/RFCGettingStarted.xml 2008-12-30 17:05:10 UTC (rev 12078)
+++ trunk/docs/userguide/en/src/main/docbook/modules/RFCGettingStarted.xml 2008-12-31 09:57:29 UTC (rev 12079)
@@ -66,11 +66,19 @@
necessary to register them in project <code>web.xml</code>
file. Add following lines in <code>web.xml</code>: </para>
<programlisting role="XML"><![CDATA[...
+<!-- Plugging the "Blue Sky" skin into the project -->
<context-param>
<param-name>org.richfaces.SKIN</param-name>
<param-value>blueSky</param-value>
</context-param>
+
+<!-- Making the RichFaces skin spread to standard HTML controls -->
+<context-param>
+ <param-name>org.richfaces.CONTROL_SKINNING</param-name>
+ <param-value>enable</param-value>
+</context-param>
+<!-- Defining and mapping the RichFaces filter -->
<filter>
<display-name>RichFaces Filter</display-name>
<filter-name>richfaces</filter-name>
@@ -85,6 +93,7 @@
<dispatcher>INCLUDE</dispatcher>
</filter-mapping>
...]]></programlisting>
+ <para>For more information on how to work with RichFaces skins read "<link linkend="Skinnability">Skinnabilty</link>" chapter.</para>
<para>Finally the <code>web.xml</code> should look like this: </para>
<programlisting role="XML"><![CDATA[<?xml version="1.0"?>
<web-app version="2.5"
@@ -102,15 +111,18 @@
<param-name>org.richfaces.SKIN</param-name>
<param-value>blueSky</param-value>
</context-param>
+
+<context-param>
+ <param-name>org.richfaces.CONTROL_SKINNING</param-name>
+ <param-value>enable</param-value>
+</context-param>
-<!-- RichFaces Filter -->
<filter>
<display-name>RichFaces Filter</display-name>
<filter-name>richfaces</filter-name>
<filter-class>org.ajax4jsf.Filter</filter-class>
</filter>
-<!-- RichFaces Filter mapping-->
<filter-mapping>
<filter-name>richfaces</filter-name>
<servlet-name>Faces Servlet</servlet-name>
@@ -200,37 +212,35 @@
<%@ taglib uri="http://richfaces.org/rich" prefix="rich"%>
<html>
- <head>
- <title>RichFaces Greeter</title>
- </head>
- <body>
- <f:view>
- <h1>RichFaces Greeter</h1>
- <a4j:form>
- <h:panelGroup style="margin-left: 10" >
- <h:outputText value="Your name: " />
- <h:inputText value="#{user.name}" >
- <f:validateLength minimum="1" maximum="30" />
- </h:inputText>
- <a4j:commandButton value="Get greeting" reRender="greeting" />
- </h:panelGroup>
- </a4j:form>
- <h:panelGroup id="greeting" >
- <h:outputText value="Hello, " rendered="#{not empty user.name}" style="margin-left: 10" />
- <h:outputText value="#{user.name}" />
- <h:outputText value="!" rendered="#{not empty user.name}" />
- </h:panelGroup>
- </f:view>
- </body>
+ <head>
+ <title>RichFaces Greeter</title>
+ </head>
+ <body>
+ <f:view>
+ <a4j:form>
+ <rich:panel header="RichFaces Greeter" style="width: 315px">
+ <h:outputText value="Your name: " />
+ <h:inputText value="#{user.name}" >
+ <f:validateLength minimum="1" maximum="30" />
+ </h:inputText>
+
+ <a4j:commandButton value="Get greeting" reRender="greeting" />
+
+ <h:panelGroup id="greeting" >
+ <h:outputText value="Hello, " rendered="#{not empty user.name}" />
+ <h:outputText value="#{user.name}" />
+ <h:outputText value="!" rendered="#{not empty user.name}" />
+ </h:panelGroup>
+ </rich:panel>
+ </a4j:form>
+ </f:view>
+ </body>
</html>]]></programlisting>
- <para>The application uses two RichFaces components: <emphasis
- role="bold">
- <property><a4j:commandButton></property>
- </emphasis> with built-in Ajax support allows rendering a
- greeting dynamically after a response comes back and
- <emphasis role="bold">
- <property><a4j:form></property>
- </emphasis> helps the button to perform the action. </para>
+ <para>The application uses three RichFaces components:
+ <emphasis role="bold"><property><rich:panel></property></emphasis> is used as visual container for information;
+ <emphasis role="bold"><property><a4j:commandButton></property></emphasis> with built-in Ajax support allows rendering a greeting dynamically after a response comes back
+ and <emphasis role="bold"><property><a4j:form></property></emphasis> helps the button to perform the action.
+ </para>
<para>Note, that the RichFaces tag library should be declared on each
JSP page. For XHTML pages add following lines for tag
library declaration: </para>
More information about the richfaces-svn-commits
mailing list