Author: vkorluzhenko Date: 2007-06-25 10:44:56 -0400 (Mon, 25 Jun 2007) New Revision: 1293 Modified: trunk/docs/userguide/en/src/main/docbook/modules/RFCfaq.xml Log: added new questions Modified: trunk/docs/userguide/en/src/main/docbook/modules/RFCfaq.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/modules/RFCfaq.xml 2007-06-25 12:44:28 UTC (rev 1292) +++ trunk/docs/userguide/en/src/main/docbook/modules/RFCfaq.xml 2007-06-25 14:44:56 UTC (rev 1293) @@ -1,76 +1,121 @@ <?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 Skinnability 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[... + <?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.... + >repo</ulink>.</para> + <para> Ajax4jsf binary is also available <ulink + url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... + >here</ulink>.</para> + <para> Most important links for RichFaces can be found <ulink + url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... + >here</ulink>.</para> + </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/... + >here</ulink> for RichFaces and <ulink + url="http://maven.exadel.com/org/ajax4jsf/ajax4jsf/1.1.2-SNAPSHOT/&q... + >here</ulink> 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... + >here</ulink>.</para> + <para> RichFaces JSF components library 3.0.2-SNAPSHOT API can be found <ulink + url="http://labs.jboss.com/file-access/default/members/jbossrichface... + >here</ulink>.</para> + </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... + >here</ulink>.</para> + </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... + >here</ulink>.</para> + </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... + >here</ulink>.</para> + <para>Source Code (SVN) can be found <ulink + url="http://anonsvn.jboss.org/repos/richfaces/trunk/richfaces-sample... + >here</ulink>.</para> + </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&... + >Here</ulink> is an article that explains the Skinnability 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</ulink>.</para> + </section> + + <section> + <?dbhtml filename="WhyRichFaceslibrarycondataTablecomp"?> + <title>Why RichFaces library contains &lt;rich:dataTable&gt; component if + the standard &lt;h:dataTable&gt; exists?</title> + <para>The answer could be found <ulink + url="http://labs.jboss.com/wiki/RichFacesArticleDataTable" + >here</ulink>.</para> + <para>Source code (SVN) could be found <ulink + url="http://anonsvn.jboss.org/repos/richfaces/trunk/richfaces-sample... + >here</ulink>.</para> + <para> Online demo for a Web application is available <ulink + url=" http://livedemo.exadel.com/richfaces-art-datatable/" + >here</ulink>.</para> + </section> + + <section> + <?dbhtml filename="WhyRichFaceslibrarycondataTablecomp"?> + <title>How to organize wizards using the &lt;rich:modalPanel&gt; component?</title> + <para>It&apos;s necessary to put <emphasis role="bold" + >&lt;a4j:include&gt;</emphasis> inside the <emphasis + role="bold">&lt;rich:modalPanel&gt;</emphasis> 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" /> @@ -80,14 +125,16 @@ </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[... + <para>For more information, follow the <ulink + url="http://labs.jboss.com/wiki/ModalPanelWizards" + >link</ulink>.</para> + </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> @@ -110,15 +157,25 @@ </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[... + </section> + + <section> + <?dbhtml filename="HowtousesuggestionBox"?> + <title>How to use &lt;rich:suggestionBox&gt; inside the + &lt;rich:modalPanel&gt; 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/... + >here</ulink> for RichFaces and <ulink + url="http://maven.exadel.com/org/ajax4jsf/ajax4jsf/1.1.2-SNAPSHOT/&q... + >here</ulink> for Ajax.</para> + <para>Also the example of using <emphasis role="bold" + >&lt;rich:suggestionBox&gt;</emphasis> inside the <emphasis + role="bold">&lt;rich:modalPanel&gt;</emphasis> content is + placed below.</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"> @@ -136,39 +193,110 @@ </ui:define> ... ]]></programlisting> - <para>In this case the popup suggestion list is above the modalPanel.</para> - </section> - + <para>In this case the popup suggestion list is above the modalPanel.</para> + </section> + <section> <?dbhtml filename="DoesRichFacesworkwithfacelets"?> <title>Does RichFaces work with facelets?</title> - <para>Main <ulink url="http://livedemo.exadel.com/richfaces-demo/"> demo</ulink>of RichFaces is a facelets based application. So, the answer is yes.</para> + <para>Main <ulink url="http://livedemo.exadel.com/richfaces-demo/"> demo</ulink> of + RichFaces is a facelets based application. So, the answer is yes.</para> </section> - + <section> <?dbhtml filename="RerenderingPartPage.html"?> - <title>How to reRender only particular row(s) of datatable?</title> - <para> - If you use "rich:dataTable" then you may use ajaxKeys attribute to bind the rowKeys to be reRendered there. After you need to point reRender on the whole table and only specified rows will be reRedered. Also you can see example about usage of "a4j:repeat" component - <ulink url="http://livedemo.exadel.com/a4j-repeat/">here</ulink&... + <title>How to reRender only particular row(s) of dataTable?</title> + <para> If you use <emphasis role="bold">&lt;rich:dataTable&gt;</emphasis> + then you may use ajaxKeys attribute to bind the rowKeys to be reRendered + there. After you need to point reRender on the whole table and only + specified rows will be reRedered. Also the example of usage of <emphasis + role="bold">&lt;a4j:repeat&gt;</emphasis> component are + available <ulink url="http://livedemo.exadel.com/a4j-repeat/" + >here</ulink>.</para> </section> - + <section> <?dbhtml filename="Isitpossibletocreatedynamicmenu"?> - <title>Is it possible to create dynamic menu using rich:dropDownMenu component?</title> - <para>rich:dropDown menu is a standard JSF component. So, creation the menu dynamically from the Java Script code is the same as for any other jsf component.</para> + <title>Is it possible to create dynamic menu using &lt;rich:dropDownMenu&gt; + component?</title> + <para><emphasis role="bold">&lt;rich:dropDown&gt;</emphasis> menu is a + standard JSF component. So, creation the menu dynamically from the Java + Script code is the same as for any other jsf component.</para> </section> - + <section> <?dbhtml filename="Isitpossibletocustomizelookofdatascroller"?> - <title>Is it possible to customize look of datascroller (the forward/back buttons) and replace them with images?</title> - <para>The answer is yes. Use facets: &quot;first_disabled&quot;, &quot;last_disabled&quot;, &quot;next_disabled&quot;, &quot;previous_disabled&quot;, &quot;fastforward_disabled&quot;, &quot;fastrewind_disabled&quot;.</para> + <title>Is it possible to customize look of dataScroller (the forward/back buttons) + and replace them with images?</title> + <para>The answer is yes. Use facets: &quot;first_disabled&quot;, + &quot;last_disabled&quot;, &quot;next_disabled&quot;, + &quot;previous_disabled&quot;, + &quot;fastforward_disabled&quot;, + &quot;fastrewind_disabled&quot;.</para> </section> - + <section> <?dbhtml filename="HowtocustomizesimpleTogglePanel"?> - <title>How to customize simpleTogglePanel? I need to change icon for toggler.</title> - <para>To customize icon for toggler use &quot;openMarker&quot; and &quot;closeMarker&quot; facets.</para> + <title>How to customize &lt;rich:simpleTogglePanel&gt;? I need to change + icon for toggler.</title> + <para>To customize icon for toggler use &quot;openMarker&quot; and + &quot;closeMarker&quot; facets.</para> </section> - + + <section> + <?dbhtml filename="Howtoredirecttoanotherpage"?> + <title>&lt;rich:dropDown&gt; component: How to redirect to another page?</title> + <para>If you want to navigate to outside your application using external URL use + following approach:</para> + <programlisting role="XML"><![CDATA[... + <rich:dropDownMenu> + … + <rich:menuItem submitMode="none" + onclick="document.location.href='http://labs.jboss.com/jbossrich... + <h:outputLink value="http://labs.jboss.com/jbossrichfaces/"> + <h:outputText value="RichFaces Home Page"></h:outputText> + </h:outputLink> + </rich:menuItem> + … + </rich:dropDownMenu> +... +]]></programlisting> + <para>Also online demo of using <emphasis role="bold" + >&lt;rich:dropDownMenu&gt;</emphasis> is available <ulink + url="http://livedemo.exadel.com/richfaces-demo/richfaces/dropDownMen... + >here</ulink>.</para> + </section> + + <section> + <?dbhtml filename="CanthedropDownMenubeincludedintreenodes"?> + <title>Can dropDownMenu be included in tree nodes?</title> + <para>The <emphasis role="bold">&lt;rich:dropDownMenu&gt;</emphasis> is + designed keeping in mind that it should not be used for contextMenu purpose. + We have a <emphasis role="bold">&lt;rich:contextMenu&gt;</emphasis> + component in the TODO list. However, it will not schedule for the nearest + versions.</para> + </section> + + <section> + <?dbhtml filename="HowtocustomizesimpleTogglePanel"?> + <title>How to pass own parameters during a modalPanel opening or closing?</title> + <para>The answer could be found in the &quot;Details of usage&quot; of <link + linkend="modalPanel">&lt;rich:modalPanel&gt; + component</link>.</para> + </section> + + <section> + <?dbhtml filename="Howtoaddalinktothetreenode"?> + <title>How to add a link to a tree node?</title> + <para>Simple code is placed below:</para> + <programlisting role="XML"><![CDATA[... + <rich:tree value="#{bean.data}" var="data"> + <rich:treeNode type="text" nodeClass="customNode" acceptedTypes="file2" onselected="return false;"> + <h:commandLink value="#{data.linkValue}" action="#{data.someAction}"/> + </rich:treeNode> + </rich:tree> +... +]]></programlisting> + </section> + </chapter>