Author: vkorluzhenko Date: 2007-06-21 10:01:35 -0400 (Thu, 21 Jun 2007) New Revision: 1251 Added: trunk/docs/userguide/en/src/main/docbook/modules/RFCfaq.xml Log: added FAQ Added: trunk/docs/userguide/en/src/main/docbook/modules/RFCfaq.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/modules/RFCfaq.xml (rev 0) +++ trunk/docs/userguide/en/src/main/docbook/modules/RFCfaq.xml 2007-06-21 14:01:35 UTC (rev 1251) @@ -0,0 +1,142 @@ +<?xml version='1.0' encoding='UTF-8'?> +<chapter id="FAQ" xreflabel="FAQ"> + <?dbhtml filename="FAQ.html"?> + <sectioninfo> + <keywordset> + <keyword>RichFaces</keyword> + </keywordset> + </sectioninfo> + <title>FAQ</title> + + <section> + <?dbhtml filename="Wherearebinary/sourcedistributionforRichFacesrelease.html"?> + <title>Where are binary/source distribution for RichFaces 3.0.1 release?</title> + <para> JBoss RichFaces downloads could be found <ulink url="http://labs.jboss.com/jbossrichfaces/downloads">here<...;. </para> + <para> The version is tagged in SVN and put in the Jboss Maven <ulink url="http://repository.jboss.com/maven2/org/richfaces/richfaces/3.0.... + <para> Ajax4jsf binary is also available <ulink url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... + <para> Most important links for RichFaces can be found <ulink url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... + </section> + + <section id="Wherearethesnapshots"> + <?dbhtml filename="Wherearethesnapshots.html"?> + <title>Where are the snapshots?</title> + <para> Nightly builds are available <ulink url="http://maven.exadel.com/org/richfaces/richfaces/3.0.2-SNAPSHOT/... for RichFaces and <ulink url="http://maven.exadel.com/org/ajax4jsf/ajax4jsf/1.1.2-SNAPSHOT/&q... for Ajax.</para> + <para> RichFaces JSF components library Tag library documentation can be found <ulink url="http://labs.jboss.com/file-access/default/members/jbossrichface... + <para> RichFaces JSF components library 3.0.2-SNAPSHOT API can be found <ulink url="http://labs.jboss.com/file-access/default/members/jbossrichface... + </section> + + <section> + <?dbhtml filename="HowtobuildRichFacessnapshotmanually"?> + <title>How to build RichFaces snapshot manually?</title> + <para>As it was mentioned <ulink url="index.html#Wherearethesnapshots"> before </ulink> you can download the snapshots or you can build them manually. This <ulink url="http://labs.jboss.com/wiki/HowToBuildRichFacesSnapshotManually.... wiki article </ulink> helps you.</para> + </section> + + <section> + <?dbhtml filename="WhatstructureofRichFacesSVNrepositoryis"?> + <title>What structure of RichFaces SVN repository is?</title> + <para>RichFaces repository structure overview can be found <ulink url="http://labs.jboss.com/wiki/RichFacesRepositoryStructureOverview... + </section> + + <section> + <?dbhtml filename="Howtobuildrichfaces-samplesapplications"?> + <title>How to build richfaces-samples applications?</title> + <para>How to build and how to use richfaces-samples applications in Eclipse is described <ulink url="http://labs.jboss.com/wiki/RichFacesRepositoryStructureOverview... + </section> + + <section> + <?dbhtml filename="IstheredemoforRichFacescomponents"?> + <title>Is there demo for RichFaces 3.0.1 components?</title> + <para>Online demo Web applications that show the most important functionality of RichFaces components are available <ulink url="http://livedemo.exadel.com/richfaces-demo/">here</ul... + <para>War file of a nightly build can be found <ulink url="http://maven.exadel.com/org/richfaces/richfaces-demo/3.0.1-SNAP... + <para>Source Code (SVN) can be found <ulink url="http://anonsvn.jboss.org/repos/richfaces/trunk/richfaces-sample... + </section> + + <section> + <?dbhtml filename="HowtouseSkinnability"?> + <title>How to use Skinnability?</title> + <para><ulink url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... is an article that explains the Skinability basics.</para> + <para>Also, the effect of predefined skins on the application whole look-and-feel could be seen <ulink url="http://livedemo.exadel.com/richfaces-demo/">here</ul... + </section> + + <section> + <?dbhtml filename="WhyRichFaceslibrarycondataTablecomp"?> + <title>Why RichFaces library contains rich:dataTable component if the standard h:dataTable exists?</title> + <para>The answer could be found <ulink url="http://labs.jboss.com/wiki/RichFacesArticleDataTable">h... + <para>Source code (SVN) could be found <ulink url="http://anonsvn.jboss.org/repos/richfaces/trunk/richfaces-sample... + <para> Online demo for a Web application is available <ulink url=" http://livedemo.exadel.com/richfaces-art-datatable/">here</uli... + </section> + + <section> + <?dbhtml filename="WhyRichFaceslibrarycondataTablecomp"?> + <title>How to organize wizards using the rich:modalPanel?</title> + <para>It’s necessary to put a4j:include inside the rich:modal panel and perform navigation inside it, as it&apos;s shown in the example below:</para> + <programlisting role="XML"><![CDATA[... + <rich:modalPanel id="mp" minHeight="200" minWidth="450" height="200" width="500" zindex="2000"> + <f:facet name="header"> + <h:outputText value="Modal Panel Title" /> + </f:facet> + <a4j:include viewId="/pages/include/first.xhtml"/> + <a href="javascript:Richfaces.hideModalPanel('mp')">hide this panel</a> + </rich:modalPanel> +... +]]></programlisting> + <para>For more information, follow the <ulink url="http://labs.jboss.com/wiki/ModalPanelWizards">link</... + </section> + + <section> + <?dbhtml filename="Howtopreventmodalpanelfromclosure"?> + <title>How to prevent modalPanel from closure if the validation inside fails?</title> + <para>Simple code is placed below to provide such behavior.</para> + <programlisting role="XML"><![CDATA[... + <ui:define name="body"> + <f:verbatim> + <a href="javascript:Richfaces.showModalPanel('_panel',{left:'auto', top:'auto'})">Show Modal Panel</a> + </f:verbatim> + <rich:modalPanel id="_panel"> + <f:facet name="header"> + <h:outputText value="test"></h:outputText> + </f:facet> + <h:form id="mpform"> + <a4j:outputPanel ajaxRendered="true"> + <h:messages id="error"></h:messages> + </a4j:outputPanel> + <h:inputText value="#{bean.property}" required="true"></h:inputText> + <a4j:commandLink value="click" oncomplete="windowclose();" reRender="test" /> + </h:form> + </rich:modalPanel> + <script type="text/javascript"> + ... + </script> + </ui:define> +... +]]></programlisting> + </section> + + <section> + <?dbhtml filename="HowtousesuggestionBox"?> + <title>How to use suggestionBox inside the modalPanel content? When I use it the popup suggestion list doesn&apos;t show since it is behind the modalPanel.</title> + <para>First of all to solve this problem you should use the latest versions of Ajax4JSF 1.1.2-SNAPSHOT and Richfaces 3.0.2-SNAPSHOT.</para> + <para> Nightly builds are available <ulink url="http://maven.exadel.com/org/richfaces/richfaces/3.0.2-SNAPSHOT/... for RichFaces and <ulink url="http://maven.exadel.com/org/ajax4jsf/ajax4jsf/1.1.2-SNAPSHOT/&q... for Ajax.</para> + <para>Also see the example of using suggestionBox inside the modalPanel content.</para> + <programlisting role="XML"><![CDATA[... + <ui:define name="body"> + <a href="javascript:Richfaces.showModalPanel('panel',{left:'auto', top:'auto'})">Show</a> + <rich:modalPanel id="panel"> + <h:form> + <h:inputText value="#{bean.property}" id="test" size="50" required="true"></h:inputText> + <rich:suggestionbox width="200" height="200" for="test" + suggestionAction="#{bean.autocomplete}" var="cap" ajaxSingle="false" limitToList="false" reRender="panel1"> + <h:column> + <h:outputText value="#{cap.text}"></h:outputText> + </h:column> + </rich:suggestionbox> + <a4j:log>....</a4j:log> + </h:form> + </rich:modalPanel> + </ui:define> +... +]]></programlisting> + <para>In this case the popup suggestion list is above the modalPanel.</para> + </section> + +</chapter>