[richfaces-svn-commits] JBoss Rich Faces SVN: r10062 - trunk/docs/faq/en/src/main/docbook/module.

Author: atsebro Date: 2008-08-13 07:42:11 -0400 (Wed, 13 Aug 2008) New Revision: 10062 Modified: trunk/docs/faq/en/src/main/docbook/module/RFCfaq.xml Log: RF-4080: Developer guide does not contain details for web.xml configuration to successfully integrate fileUpload component with myfaces framework Modified: trunk/docs/faq/en/src/main/docbook/module/RFCfaq.xml =================================================================== --- trunk/docs/faq/en/src/main/docbook/module/RFCfaq.xml 2008-08-13 11:38:47 UTC (rev 10061) +++ trunk/docs/faq/en/src/main/docbook/module/RFCfaq.xml 2008-08-13 11:42:11 UTC (rev 10062) @@ -1,72 +1,74 @@ <?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="WherecouldIfindadditionalinformationonRichFaces.html"?> - <title>Where could I find additional information on RichFaces?</title> - <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> - <?dbhtml filename="Wherearebinary/sourcedistributionforRichFacesrelease.html"?> - <title>Where are binary/source distribution for RichFaces?</title> - <para> - <!-- RichFaces are built using CDK (Component Development Kit). + <?dbhtml filename="FAQ.html"?> + <sectioninfo> + <keywordset> + <keyword>RichFaces</keyword> + </keywordset> + </sectioninfo> + <title>FAQ</title> + <section> + <?dbhtml filename="WherecouldIfindadditionalinformationonRichFaces.html"?> + <title>Where could I find additional information on RichFaces?</title> + <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> + <?dbhtml filename="Wherearebinary/sourcedistributionforRichFacesrelease.html"?> + <title>Where are binary/source distribution for RichFaces?</title> + <para> + <!-- RichFaces are built using CDK (Component Development Kit). CDK generates the library based on the meta-data, component templates and hand-written java classes. What you see in the richfaces-ui-3.1.0-src.zip is a truly source, i.e. a source for CDK. To the debug purpose, you need the source code that is generated by CDK before it is compiled into the binary. --> - There are two places where you can find binary/source distribution: - <itemizedlist> - <listitem> - JBoss RichFaces Downloads area which can be found <ulink url="http://labs.jboss.com/jbossrichfaces/downloads/">here&l...;. - Source distribution you can see in the <code>richfaces-ui-3.2.1-src.zip</code>. - Binary stored in <code>richfaces-ui-3.2.1-bin.zip</code> - </listitem> - <listitem> - If you use Maven, Maven knows the place where all distributions are stored. - Actual links to the Maven repository can be found <ulink url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... - </listitem> - </itemizedlist> - </para> - </section> + There are two places where you can find binary/source distribution: <itemizedlist> + <listitem> JBoss RichFaces Downloads area which can be found + <ulink + url="http://labs.jboss.com/jbossrichfaces/downloads/" + >here</ulink>. Source distribution you + can see in the + <code>richfaces-ui-3.2.1-src.zip</code>. Binary + stored in <code>richfaces-ui-3.2.1-bin.zip</code> + </listitem> + <listitem> If you use Maven, Maven knows the place where all + distributions are stored. Actual links to the + Maven repository can be found <ulink + url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... + >here</ulink> + </listitem> + </itemizedlist> + </para> + </section> - <section> - <?dbhtml filename="HowtobuildRichFacessnapshotmanually.html"?> - <title>How to build RichFaces snapshot manually?</title> - <para>This <ulink - url="http://labs.jboss.com/wiki/HowToBuildRichFacesSnapshotManually&... - > wiki article</ulink> helps you to find an answer.</para> - </section> + <section> + <?dbhtml filename="HowtobuildRichFacessnapshotmanually.html"?> + <title>How to build RichFaces snapshot manually?</title> + <para>This <ulink + url="http://labs.jboss.com/wiki/HowToBuildRichFacesSnapshotManually&... + > wiki article</ulink> helps you to find an answer.</para> + </section> - <section> - <?dbhtml filename="HowtobuildRichFacessnapshotmanually.html"?> - <title>How to configure Maven for RichFaces</title> - <itemizedlist> - <listitem> - <para>Download and install Maven if you have not it yet installed. - Follow the instruction at <ulink - url="http://maven.apache.org/download.html"> - http://maven.apache.org/download.html</ulink>.</para> - </listitem> + <section> + <?dbhtml filename="HowtobuildRichFacessnapshotmanually.html"?> + <title>How to configure Maven for RichFaces</title> + <itemizedlist> + <listitem> + <para>Download and install Maven if you have not it yet + installed. Follow the instruction at <ulink + url="http://maven.apache.org/download.html" + > + http://maven.apache.org/download.html</ulink>.</para> + </listitem> - <listitem> - <para>Open - &lt;Maven-Root&gt;/conf/settings.xml - file to edit</para> + <listitem> + <para>Open &lt;Maven-Root&gt;/conf/settings.xml file + to edit</para> - <para>Add into the <code>&lt;profile&gt;</code> - section:</para> - <programlisting role="XML"><![CDATA[ + <para>Add into the <code>&lt;profile&gt;</code> + section:</para> + <programlisting role="XML"><![CDATA[ <id>RichFaces</id> <repositories> <repository> @@ -128,103 +130,113 @@ </pluginRepository> </pluginRepositories> ]]></programlisting> - <para> Add into the - <code>&lt;activeProfiles&gt;</code> section:</para> - <programlisting role="XML"><![CDATA[<activeProfile>RichFaces</activeProfile>]]></programlisting> + <para> Add into the + <code>&lt;activeProfiles&gt;</code> + section:</para> + <programlisting role="XML"><![CDATA[<activeProfile>RichFaces</activeProfile>]]></programlisting> - </listitem> + </listitem> - </itemizedlist> - </section> + </itemizedlist> + </section> - <section> - <?dbhtml filename="WhatstructureofRichFacesSVNrepositoryis.html"?> - <title>What is the structure of RichFaces SVN repository?</title> - <para>RichFaces repository structure overview can be found <ulink - url="http://labs.jboss.com/wiki/RichFacesRepositoryStructureOverview... - >here</ulink>.</para> - </section> + <section> + <?dbhtml filename="WhatstructureofRichFacesSVNrepositoryis.html"?> + <title>What is the structure of RichFaces SVN repository?</title> + <para>RichFaces repository structure overview can be found <ulink + url="http://labs.jboss.com/wiki/RichFacesRepositoryStructureOverview... + + </section> - <section> - <?dbhtml filename="Howtobuildrichfaces-samplesapplications.html"?> - <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="Howtobuildrichfaces-samplesapplications.html"?> + <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.html"?> - <title>Where could I find a demo for RichFaces 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/samples/richfaces-demo/3.... - >here</ulink>.</para> - <para>Source Code (SVN) can be found <ulink - url="http://anonsvn.jboss.org/repos/richfaces/trunk/samples/richface... - >here</ulink>.</para> - <para>See also <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >how to prevent richfaces-demo deployment failed</ulink>.</para> - </section> + <section> + <?dbhtml filename="IstheredemoforRichFacescomponents.html"?> + <title>Where could I find a demo for RichFaces 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</ulink>.</para> + <para>War file of a nightly build can be found <ulink + url="http://maven.exadel.com/org/richfaces/samples/richfaces-demo/3.... + + <para>Source Code (SVN) can be found <ulink + url="http://anonsvn.jboss.org/repos/richfaces/trunk/samples/richface... + + <para>See also <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >how to prevent richfaces-demo deployment + failed</ulink>.</para> + </section> - <section> - <?dbhtml filename="HowtouseSkinnability.html"?> - <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> For information you can also see discussion about this problem on the <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >RichFaces Users Forum</ulink></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="HowtouseSkinnability.html"?> + <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> For information you can also see discussion about this problem on the + <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >RichFaces Users Forum</ulink></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="Whythereisaproblemwithprototypes.html"?> - <title>Why does a problem with prototypes in RichFaces 3.1.0 happen? The - Prototype.Browser() function can&apos;t be found.</title> - <para>RichFaces 3.1.0 has been released with the latest Prototype 1.5.1.1. The - conflict happens because on your page an older version of prototypes that - can be added from Tomahawk 1.1.6 is used. See the solution for the problem - <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >here.</ulink></para> - </section> + <section> + <?dbhtml filename="Whythereisaproblemwithprototypes.html"?> + <title>Why does a problem with prototypes in RichFaces 3.1.0 happen? The + Prototype.Browser() function can&apos;t be found.</title> + <para>RichFaces 3.1.0 has been released with the latest Prototype 1.5.1.1. The + conflict happens because on your page an older version of prototypes + that can be added from Tomahawk 1.1.6 is used. See the solution for + the problem <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >here.</ulink></para> + </section> - <section> - <?dbhtml filename="WhyRichFaceslibrarycondataTablecomp.html"?> - <title>Why RichFaces library contains &lt;rich:dataTable&gt; component, - though there is the standard &lt;h:dataTable&gt;?</title> - <para>The article about <emphasis role="bold" - ><property>&lt;rich:dataTable&gt;</property></emphasis> flexibility can 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/samples/richface... - >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.html"?> + <title>Why RichFaces library contains &lt;rich:dataTable&gt; component, + though there is the standard &lt;h:dataTable&gt;?</title> + <para>The article about <emphasis role="bold"> + <property>&lt;rich:dataTable&gt;</property> + </emphasis> flexibility can be found <ulink + url="http://labs.jboss.com/wiki/RichFacesArticleDataTable" + + <para>Source code (SVN) could be found <ulink + url="http://anonsvn.jboss.org/repos/richfaces/trunk/samples/richface... + + <para> Online demo for a Web application is available <ulink + url=" http://livedemo.exadel.com/richfaces-art-datatable/" + + </section> - <section id="Organizewizards"> - <?dbhtml filename="Organizewizards.html"?> - <title>How to organize wizards using the &lt;rich:modalPanel&gt; component?</title> - <para>It&apos;s necessary to put <emphasis role="bold" - ><property>&lt;a4j:include&gt;</property></emphasis> inside the <emphasis - role="bold"><property>&lt;rich:modalPanel&gt;</property></emphasis> and perform - navigation inside it, as it&apos;s shown in the example below:</para> + <section id="Organizewizards"> + <?dbhtml filename="Organizewizards.html"?> + <title>How to organize wizards using the &lt;rich:modalPanel&gt; + component?</title> + <para>It&apos;s necessary to put <emphasis role="bold"> + <property>&lt;a4j:include&gt;</property> + </emphasis> inside the <emphasis role="bold"> + <property>&lt;rich:modalPanel&gt;</property> + </emphasis> and perform navigation inside it, as it&apos;s shown + in the example below:</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <f:verbatim> <a href="javascript:Richfaces.showModalPanel('_panel',{left:'auto', top:'auto'})">Show Modal Panel</a> </f:verbatim> @@ -265,75 +277,80 @@ ... ]]></programlisting> - <para>The discussion about <emphasis role="bold" - ><property>&lt;a4j:include&gt;</property></emphasis> and navigation rules can be found on - the <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >Ajax Users Forum</ulink>.</para> - </section> + <para>The discussion about <emphasis role="bold"> + <property>&lt;a4j:include&gt;</property> + </emphasis> and navigation rules can be found on the <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >Ajax Users Forum</ulink>.</para> + </section> - <section> - <?dbhtml filename="Howtopreventmodalpanelfromclosure.html"?> - <title>How to prevent modalPanel from closing when the validation inside fails?</title> - <para>Examples of validation in <emphasis role="bold" - ><property>&lt;rich:modalPanel&gt;</property></emphasis> could be found in the - <ulink url="http://labs.jboss.com/wiki/ModalPanelValidation">Wiki - article</ulink> and on the <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >RichFaces Users Forum</ulink>. </para> - </section> + <section> + <?dbhtml filename="Howtopreventmodalpanelfromclosure.html"?> + <title>How to prevent modalPanel from closing when the validation inside fails?</title> + <para>Examples of validation in <emphasis role="bold"> + <property>&lt;rich:modalPanel&gt;</property> + </emphasis> could be found in the <ulink + url="http://labs.jboss.com/wiki/ModalPanelValidation">Wiki + article</ulink> and on the <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >RichFaces Users Forum</ulink>. </para> + </section> - <section> - <?dbhtml filename="HowtousesuggestionBox.html"?> - <title>Why when I use suggestionBox inside the modalPanel content the popup - suggestion list doesn&apos;t show since it is behind the modalPanel.</title> - <para>To solve this problem you should use the latest versions of RichFaces.</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> + <?dbhtml filename="HowtousesuggestionBox.html"?> + <title>Why when I use suggestionBox inside the modalPanel content the popup + suggestion list doesn&apos;t show since it is behind the + modalPanel.</title> + <para>To solve this problem you should use the latest versions of RichFaces.</para> + <para> Most important links for RichFaces can be found <ulink + url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... + - </section> + </section> - <section> - <?dbhtml filename="DoesRichFacesworkwithfacelets.html"?> - <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. Full Facelets support is one of - the main features. Hence, the answer is yes.</para> - </section> + <section> + <?dbhtml filename="DoesRichFacesworkwithfacelets.html"?> + <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. Full Facelets support is + one of the main features. Hence, the answer is yes.</para> + </section> - <section> - <?dbhtml filename="Isitpossibletocreatedynamicmenu.html"?> - <title>Is it possible to create dynamic menu using &lt;rich:dropDownMenu&gt; - component?</title> - <para><emphasis role="bold"><property>&lt;rich:dropDownMenu&gt;</property></emphasis> is a - standard JSF component. Thus, creation of the menu dynamically from the Java - Script code is the same as for any other jsf component.</para> - <para>For more information follow the <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >link</ulink>.</para> - </section> + <section> + <?dbhtml filename="Isitpossibletocreatedynamicmenu.html"?> + <title>Is it possible to create dynamic menu using + &lt;rich:dropDownMenu&gt; component?</title> + <para><emphasis role="bold"> + <property>&lt;rich:dropDownMenu&gt;</property> + </emphasis> is a standard JSF component. Thus, creation of the menu + dynamically from the Java Script code is the same as for any other jsf + component.</para> + <para>For more information follow the <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >link</ulink>.</para> + </section> - <section> - <?dbhtml filename="Isitpossibletocustomizelookofdatascroller.html"?> - <title>Is it possible to customize the look of datascroller (the forward/back - buttons) and replace them with an images?</title> - <para>The answer is yes. </para> - <para>Component provides two controllers groups for switching:</para> - <itemizedlist> - <listitem>Page numbers for switching onto a particular page</listitem> - <listitem>The controls of fast switching: &quot;first&quot;, - &quot;last&quot;, &quot;next&quot;, - &quot;previous&quot;, &quot;fastforward&quot;, - &quot;fastrewind&quot;</listitem> - </itemizedlist> - <para>The controls of fast switching are created adding the facets component with - the corresponding name:</para> + <section> + <?dbhtml filename="Isitpossibletocustomizelookofdatascroller.html"?> + <title>Is it possible to customize the look of datascroller (the forward/back + buttons) and replace them with an images?</title> + <para>The answer is yes. </para> + <para>Component provides two controllers groups for switching:</para> + <itemizedlist> + <listitem>Page numbers for switching onto a particular page</listitem> + <listitem>The controls of fast switching: &quot;first&quot;, + &quot;last&quot;, &quot;next&quot;, + &quot;previous&quot;, + &quot;fastforward&quot;, + &quot;fastrewind&quot;</listitem> + </itemizedlist> + <para>The controls of fast switching are created adding the facets component + with the corresponding name:</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[ ... + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[ ... <rich:datascroller for="table" maxPages="10"> <f:facet name="first"> <h:outputText value="First"/> @@ -344,23 +361,31 @@ </rich:datascroller> ... ]]></programlisting> - <para> There are also facets used to create the disabled states: - <emphasis><property>&quot;first_disabled&quot;</property></emphasis>, <emphasis><property>&quot;last_disabled&quot;</property></emphasis>, - <emphasis><property>&quot;next_disabled&quot;</property></emphasis>, <emphasis><property>&quot;previous_disabled&quot;</property></emphasis>, - <emphasis><property>&quot;fastforward_disabled&quot;</property></emphasis>, - <emphasis><property>&quot;fastrewind_disabled&quot;</property></emphasis>. </para> - </section> + <para> There are also facets used to create the disabled states: <emphasis> + <property>&quot;first_disabled&quot;</property> + </emphasis>, <emphasis> + <property>&quot;last_disabled&quot;</property> + </emphasis>, <emphasis> + <property>&quot;next_disabled&quot;</property> + </emphasis>, <emphasis> + <property>&quot;previous_disabled&quot;</property> + </emphasis>, <emphasis> + <property>&quot;fastforward_disabled&quot;</property> + </emphasis>, <emphasis> + <property>&quot;fastrewind_disabled&quot;</property> + </emphasis>. </para> + </section> - <section> - <?dbhtml filename="Howtoredirecttoanotherpage.html"?> - <title>How to place simple links inside menu?</title> - <para>If you want to navigate outside, when application uses an external URL, you - should use the following approach:</para> + <section> + <?dbhtml filename="Howtoredirecttoanotherpage.html"?> + <title>How to place simple links inside menu?</title> + <para>If you want to navigate outside, when application uses an external URL, + you should use the following approach:</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <rich:dropDownMenu> ... <rich:menuItem submitMode="none" @@ -373,45 +398,48 @@ </rich:dropDownMenu> ... ]]></programlisting> - <para>Also online demo <emphasis role="bold" - ><property>&lt;rich:dropDownMenu&gt;</property></emphasis> component is available <ulink - url="http://livedemo.exadel.com/richfaces-demo/richfaces/dropDownMen... - >here</ulink>.</para> - </section> + <para>Also online demo <emphasis role="bold"> + <property>&lt;rich:dropDownMenu&gt;</property> + </emphasis> component is available <ulink + url="http://livedemo.exadel.com/richfaces-demo/richfaces/dropDownMen... + + </section> - <section> - <?dbhtml filename="CanthedropDownMenubeincludedintreenodes.html"?> - <title>Can I use dropDownMenu as context menu?</title> - <para>The <emphasis role="bold"><property>&lt;rich:dropDownMenu&gt;</property></emphasis> is - designed keeping in mind that it should not be used for a contextMenu - purpose. We have a <emphasis role="bold" - ><property>&lt;rich:contextMenu&gt;</property></emphasis> component in the TODO list. - However, it is not schedule for the nearest versions.</para> - </section> + <section> + <?dbhtml filename="CanthedropDownMenubeincludedintreenodes.html"?> + <title>Can I use dropDownMenu as context menu?</title> + <para>The <emphasis role="bold"> + <property>&lt;rich:dropDownMenu&gt;</property> + </emphasis> is designed keeping in mind that it should not be used for + a contextMenu purpose. We have a <emphasis role="bold"> + <property>&lt;rich:contextMenu&gt;</property> + </emphasis> component in the TODO list. However, it is not schedule + for the nearest versions.</para> + </section> - <section> - <?dbhtml filename="HowtocustomizesimpleTogglePanel.html"?> - <title>How to pass own parameters during a modalPanel opening or closing?</title> - <para> You can pass your parameters during modalPanel opening or closing. This - passing could be performed in the following way: </para> + <section> + <?dbhtml filename="HowtocustomizesimpleTogglePanel.html"?> + <title>How to pass own parameters during a modalPanel opening or closing?</title> + <para> You can pass your parameters during modalPanel opening or closing. This + passing could be performed in the following way: </para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="JAVA"><![CDATA[Richfaces.showModalPanel('panelId', {left: auto}, {param1: value1});]]></programlisting> - <para> Thus, except the standard modalPanel parameters you can pass any of your own - parameters. </para> - </section> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="JAVA"><![CDATA[Richfaces.showModalPanel('panelId', {left: auto}, {param1: value1});]]></programlisting> + <para> Thus, except the standard modalPanel parameters you can pass any of your + own parameters. </para> + </section> - <section> - <?dbhtml filename="Howtoaddalinktothetreenode.html"?> - <title>How to add a simple link to the tree node?</title> - <para>Simple code is placed below:</para> + <section> + <?dbhtml filename="Howtoaddalinktothetreenode.html"?> + <title>How to add a simple link to the tree node?</title> + <para>Simple code is placed below:</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <rich:tree ...> ... <rich:treeNode submitMode="none" @@ -424,25 +452,25 @@ </rich:tree ...> ... ]]></programlisting> - </section> + </section> - <section> - <?dbhtml filename="Isitpossibletoplacetabsvertically.html"?> - <title>Is it possible to place tabs upright in the tabPanel?</title> - <para>It&apos;s not possible to place tabs upright in the tabPanel. For this - purporse use togglePanel. Toggle controls can be placed anywhere in the - layout.</para> - </section> + <section> + <?dbhtml filename="Isitpossibletoplacetabsvertically.html"?> + <title>Is it possible to place tabs upright in the tabPanel?</title> + <para>It&apos;s not possible to place tabs upright in the tabPanel. For this + purporse use togglePanel. Toggle controls can be placed anywhere in + the layout.</para> + </section> - <section> - <?dbhtml filename="HowtogetaacommandButton.html"?> - <title>How to get a commandButton working within the modalPanel?</title> - <para>Simple code is placed below:</para> + <section> + <?dbhtml filename="HowtogetaacommandButton.html"?> + <title>How to get a commandButton working within the modalPanel?</title> + <para>Simple code is placed below:</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <rich:modalPanel> <f:facet name="header"> <h:outputText value="Test" /> @@ -456,27 +484,38 @@ </rich:modalPanel> ... ]]></programlisting> - <para> - <note> - <title>Note:</title><para>Two rules are important for modalPanel: </para><itemizedlist> - <listitem><para>modalPanel must have its own form if it has form - elements (input or/and command components) inside - (as it was shown in the example above) </para></listitem> - <listitem><para>modalPanel must not be included into the form (on - any level up) if it has the form inside.</para></listitem> - </itemizedlist></note> - </para> - </section> + <para> + <note> + <title>Note:</title> + <para>Two rules are important for modalPanel: </para> + <itemizedlist> + <listitem> + <para>modalPanel must have its own form + if it has form elements (input + or/and command components) + inside (as it was shown in the + example above) </para> + </listitem> + <listitem> + <para>modalPanel must not be included + into the form (on any level + up) if it has the form + inside.</para> + </listitem> + </itemizedlist> + </note> + </para> + </section> - <section> - <?dbhtml filename="Howtodefinecurrentselectedtab.html"?> - <title>How to define the currently selected tab?</title> - <para> Simple code is placed below:</para> + <section> + <?dbhtml filename="Howtodefinecurrentselectedtab.html"?> + <title>How to define the currently selected tab?</title> + <para> Simple code is placed below:</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <rich:tabPanel selectedTab="t2"> <rich:tab label="tab 1" name="t1"> <h:outputText value="tab 1" /> @@ -490,36 +529,36 @@ </rich:tabPanel> ... ]]></programlisting> - </section> + </section> - <section> - <?dbhtml filename="Howtoremembercurrentselectedtab.html"?> - <title>How to remember the current selected tab?</title> - <para> For necessary information you can see discussion about this problem on the - <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >RichFaces Users Forum</ulink>.</para> - </section> + <section> + <?dbhtml filename="Howtoremembercurrentselectedtab.html"?> + <title>How to remember the current selected tab?</title> + <para> For necessary information you can see discussion about this problem on + the <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >RichFaces Users Forum</ulink>.</para> + </section> - <section> - <?dbhtml filename="Howtonavigatefromonetabtoanother.html"?> - <title>How to navigate from one tab to another using buttons (apart from tabPanel - functionality)?</title> - <para> For necessary information you can see <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >RichFaces Users Forum</ulink>.</para> - </section> + <section> + <?dbhtml filename="Howtonavigatefromonetabtoanother.html"?> + <title>How to navigate from one tab to another using buttons (apart from + tabPanel functionality)?</title> + <para> For necessary information you can see <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >RichFaces Users Forum</ulink>.</para> + </section> - <section> - <?dbhtml filename="Howtoretrievethecurrentvalue.html"?> - <title>How to retrieve the current value from the inputNumberSlider?</title> - <para>To catch the value of the inputNumberSlider from the JavaScript, use the - following approach:</para> + <section> + <?dbhtml filename="Howtoretrievethecurrentvalue.html"?> + <title>How to retrieve the current value from the inputNumberSlider?</title> + <para>To catch the value of the inputNumberSlider from the JavaScript, use the + following approach:</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <rich:inputNumberSlider width="500" step="20" onchange="someFunctionCall(this.input.value)" minValue="0" @@ -536,35 +575,35 @@ </script> ... ]]></programlisting> - </section> + </section> - <section> - <?dbhtml filename="Howtoapplyskins.html"?> - <title>How to apply skins to the standard input components?</title> - <para>The answer could be found <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >here</ulink>.</para> - </section> + <section> + <?dbhtml filename="Howtoapplyskins.html"?> + <title>How to apply skins to the standard input components?</title> + <para>The answer could be found <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + + </section> - <section> - <?dbhtml filename="Isthereawaytocapturetherowdata.html"?> - <title>Is there a way to capture the rowdata of dataTable and subTable?</title> - <para> For necessary information you can see discussion about this problem on the - <ulink - url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... - >RichFaces Users Forum</ulink></para> - </section> + <section> + <?dbhtml filename="Isthereawaytocapturetherowdata.html"?> + <title>Is there a way to capture the rowdata of dataTable and subTable?</title> + <para> For necessary information you can see discussion about this problem on + the <ulink + url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... + >RichFaces Users Forum</ulink></para> + </section> - <section> - <?dbhtml filename="Isitpossibletouse thedatascroller.html"?> - <title>Is it possible to use datascroller without its table border and styles (to - show only links)?</title> - <para> It&apos; necessary to redefine rich* classes for example like this:</para> + <section> + <?dbhtml filename="Isitpossibletouse thedatascroller.html"?> + <title>Is it possible to use datascroller without its table border and styles + (to show only links)?</title> + <para> It&apos; necessary to redefine rich* classes for example like this:</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="CSS"><![CDATA[.rich-datascr-button { + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="CSS"><![CDATA[.rich-datascr-button { border: 0px; } .rich-dtascroller-table { @@ -573,65 +612,67 @@ .rich-datascr-button { background-color: transparent; }]]></programlisting> - </section> + </section> - <section> - <?dbhtml filename="subTableincombinationwithdataTable.html"?> - <title>How to use subTable in combination with dataTable?</title> - <para>The answer could be found <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >here</ulink>.</para> - </section> + <section> + <?dbhtml filename="subTableincombinationwithdataTable.html"?> + <title>How to use subTable in combination with dataTable?</title> + <para>The answer could be found <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + + </section> - <section id="Truepagination"> - <?dbhtml filename="Howtodotruepagination.html"?> - <title>How to do correct pagination using datascroller (load a part of data from - database)?</title> - <para>The answer could be found on the <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >RichFaces Users Forum</ulink>.</para> - <para>How to use <emphasis role="bold"><property>&lt;rich:dataTable&gt;</property></emphasis> and - <emphasis role="bold"><property>&lt;rich:dataScroller&gt;</property></emphasis> - in a context of Extended Data Model see <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >here</ulink>.</para> - </section> + <section id="Truepagination"> + <?dbhtml filename="Howtodotruepagination.html"?> + <title>How to do correct pagination using datascroller (load a part of data from + database)?</title> + <para>The answer could be found on the <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >RichFaces Users Forum</ulink>.</para> + <para>How to use <emphasis role="bold"> + <property>&lt;rich:dataTable&gt;</property> + </emphasis> and <emphasis role="bold"> + <property>&lt;rich:dataScroller&gt;</property> + </emphasis> in a context of Extended Data Model see <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + + </section> - <section> - <?dbhtml filename="Howtomakehtmlscrollbars.html"?> - <title>How to make html scrollbars in modalPanel?</title> - <para>The answer could be found on the RichFaces Users Forum:</para> - <itemizedlist> - <listitem> - <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&amp;p=4062877#4062877</ulink> - </listitem> - <listitem> - <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&amp;t=105412</ulink> - </listitem> - </itemizedlist> + <section> + <?dbhtml filename="Howtomakehtmlscrollbars.html"?> + <title>How to make html scrollbars in modalPanel?</title> + <para>The answer could be found on the RichFaces Users Forum:</para> + <itemizedlist> + <listitem> + <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&amp;p=4062877#4062877</ulink> + </listitem> + <listitem> + <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&amp;t=105412</ulink> + </listitem> + </itemizedlist> - </section> + </section> - <section> - <?dbhtml filename="HowtoExpand/CollapseTreeNodesfromcode.html"?> - <title>How to expand/collapse tree nodes from code?</title> - <para>The answer could be found <ulink - url="http://labs.jboss.com/wiki/ExpandCollapseTreeNodes" - >here</ulink>.</para> - </section> + <section> + <?dbhtml filename="HowtoExpand/CollapseTreeNodesfromcode.html"?> + <title>How to expand/collapse tree nodes from code?</title> + <para>The answer could be found <ulink + url="http://labs.jboss.com/wiki/ExpandCollapseTreeNodes" + + </section> - <section> - <?dbhtml filename="HowtouseJavaScriptAPI.html"?> - <title>How to use JavaScript API?</title> - <para>The simple code is placed below:</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... + <section> + <?dbhtml filename="HowtouseJavaScriptAPI.html"?> + <title>How to use JavaScript API?</title> + <para>The simple code is placed below:</para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <a4j:form id="form"> <h:panelGroup id="test" columns="2" style="width: 300px"> <h:selectBooleanCheckbox value="#{bean.check}"> @@ -646,71 +687,74 @@ </a4j:form> ... ]]></programlisting> - </section> + </section> - <section> - <?dbhtml filename="HowtoloadtheScriptaculouslibrary.html"?> - <title>How to load the Scriptaculous library?</title> - <para>To load the whole Scriptaculous library shipped with RichFaces use <emphasis - role="bold">&lt;a4j:loadScript&gt;</emphasis> tag.</para> + <section> + <?dbhtml filename="HowtoloadtheScriptaculouslibrary.html"?> + <title>How to load the Scriptaculous library?</title> + <para>To load the whole Scriptaculous library shipped with RichFaces use + <emphasis role="bold" + >&lt;a4j:loadScript&gt;</emphasis> tag.</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <a4j:loadScript src="resource://scriptaculous.js" /> ... ]]></programlisting> - <para> Thus, this command allows loading an integrated version of the library that - includes all existing scriptaculous files except unittest.js. </para> - <para> If you don&apos;t want to load the whole library, but only the particular - file, for example, <code>effect.js</code>, use the following line: </para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... + <para> Thus, this command allows loading an integrated version of the library + that includes all existing scriptaculous files except unittest.js. </para> + <para> If you don&apos;t want to load the whole library, but only the + particular file, for example, <code>effect.js</code>, use the + following line: </para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <a4j:loadScript src="resource://scriptaculous/effect.js" /> ... ]]></programlisting> - <para> Remember, it does not make sense to load the particular file if you already - load the whole version. </para> + <para> Remember, it does not make sense to load the particular file if you + already load the whole version. </para> - <para>For more information see <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >RichFaces Users Forum</ulink>.</para> - </section> + <para>For more information see <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >RichFaces Users Forum</ulink>.</para> + </section> - <section> - <?dbhtml filename="Howtoavoidaproblemwithtextwrapping.html"?> - <title>How to avoid a problem with text wrapping in &lt;rich:tab&gt; in - Internet Explorer 7?</title> - <para>A problem with tab height occurs in IE 7. The tab height is correct in Firefox - and IE 6. This is IE&apos;s 7 bug. As a temporary solution you can try - to change doctype declaration from:</para> - <programlisting role="XML"><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">]]></programlisting> - <para>to:</para> - <programlisting role="XML"><![CDATA[<!doctype html public "-//w3c//dtd html 4.0 transitional//en">]]></programlisting> - <para>See also <ulink url="http://jira.jboss.com/jira/browse/RF-1011" - >http://jira.jboss.com/jira/browse/RF-1011</ulink>.</para> - </section> + <section> + <?dbhtml filename="Howtoavoidaproblemwithtextwrapping.html"?> + <title>How to avoid a problem with text wrapping in &lt;rich:tab&gt; in + Internet Explorer 7?</title> + <para>A problem with tab height occurs in IE 7. The tab height is correct in + Firefox and IE 6. This is IE&apos;s 7 bug. As a temporary solution + you can try to change doctype declaration from:</para> + <programlisting role="XML"><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">]]></programlisting> + <para>to:</para> + <programlisting role="XML"><![CDATA[<!doctype html public "-//w3c//dtd html 4.0 transitional//en">]]></programlisting> + <para>See also <ulink url="http://jira.jboss.com/jira/browse/RF-1011" + >http://jira.jboss.com/jira/browse/RF-1011</ulink>.</para> + </section> - <section> - <?dbhtml filename="Howtosaveeffectstatus.html"?> - <title>How to save &lt;rich:effect&gt; status?</title> - <para><emphasis role="bold"><property>&lt;rich:effect&gt;</property></emphasis> component has - several callback methods such as beforeStart, afterFinish. You can use them - to save the status.</para> - <para> See also <ulink - url="http://wiki.script.aculo.us/scriptaculous/show/CoreEffects" - >core effects</ulink> in scriptaculous.</para> - </section> + <section> + <?dbhtml filename="Howtosaveeffectstatus.html"?> + <title>How to save &lt;rich:effect&gt; status?</title> + <para><emphasis role="bold"> + <property>&lt;rich:effect&gt;</property> + </emphasis> component has several callback methods such as + beforeStart, afterFinish. You can use them to save the status.</para> + <para> See also <ulink + url="http://wiki.script.aculo.us/scriptaculous/show/CoreEffects" + >core effects</ulink> in scriptaculous.</para> + </section> - <section> - <?dbhtml filename="Howtosaveeffectstatus.html"?> - <title>How to send an additional parameter to server working with - &lt;rich:suggestionbox&gt;?</title> - <para>An example is placed below:</para> - <programlisting role="XML"><![CDATA[... + <section> + <?dbhtml filename="Howtosaveeffectstatus.html"?> + <title>How to send an additional parameter to server working with + &lt;rich:suggestionbox&gt;?</title> + <para>An example is placed below:</para> + <programlisting role="XML"><![CDATA[... <rich:suggestionbox width="200" height="200" for="test" suggestionAction="#{bean.autocomplete}" var="cap"> <h:column> <f:facet name="header"> @@ -724,30 +768,31 @@ </rich:suggestionbox> ... ]]></programlisting> - <para>In the example <property>&quot;onselect&quot;</property> event is used - for sending selected value to the server. It&apos;s also possible to - pass additional fields of selected object (which don&apos;t belong to <emphasis> - <property>&quot;fetchvalue&quot;</property> - </emphasis> attribute.)</para> - </section> + <para>In the example <property>&quot;onselect&quot;</property> event is + used for sending selected value to the server. It&apos;s also + possible to pass additional fields of selected object (which + don&apos;t belong to <emphasis> + <property>&quot;fetchvalue&quot;</property> + </emphasis> attribute.)</para> + </section> - <section> - <?dbhtml filename="Howtosetrich:dataTableborder.html"?> - <title>How to set &lt;rich:dataTable&gt; border to 0px?</title> - <para>Add the following code to your css file:</para> - <programlisting role="CSS"><![CDATA[... + <section> + <?dbhtml filename="Howtosetrich:dataTableborder.html"?> + <title>How to set &lt;rich:dataTable&gt; border to 0px?</title> + <para>Add the following code to your css file:</para> + <programlisting role="CSS"><![CDATA[... .rich-table, .rich-table-header,.rich-table-headercell, .rich-table-cell, .rich-subtable-cell, .rich-table-footercell, .rich-subtable-footercell { border-width:0px; } ... ]]></programlisting> - </section> + </section> - <section> - <?dbhtml filename="Howtosetrich:dataTableborder.html"?> - <title>How to create &lt;rich:suggestionBox&gt; dynamically?</title> - <para>This is a working example:</para> - <programlisting role="JAVA"><![CDATA[... + <section> + <?dbhtml filename="Howtosetrich:dataTableborder.html"?> + <title>How to create &lt;rich:suggestionBox&gt; dynamically?</title> + <para>This is a working example:</para> + <programlisting role="JAVA"><![CDATA[... org.apache.myfaces.component.html.ext.HtmlInputText searchBox = new org.apache.myfaces.component.html.ext.HtmlInputText(); searchBox.setId( "inputQuery" ); bar.getChildren().add( searchBox ); @@ -784,311 +829,341 @@ bar.getChildren().add( suggestions ); ... ]]></programlisting> - <para> See also <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >RichFaces User Forum</ulink>.</para> - </section> + <para> See also <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >RichFaces User Forum</ulink>.</para> + </section> - <section id="Howtoapplybuttonlable"> - <?dbhtml filename="Howtoapplybuttonlable .html"?> - <title>How to apply button label for &lt;rich: calendar&gt;?</title> - <para> Necessary information could be found on the <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >RichFaces User Forum</ulink>.</para> - </section> + <section id="Howtoapplybuttonlable"> + <?dbhtml filename="Howtoapplybuttonlable .html"?> + <title>How to apply button label for &lt;rich: calendar&gt;?</title> + <para> Necessary information could be found on the <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >RichFaces User Forum</ulink>.</para> + </section> - <section id="DecidingWhatToChangeOnTheServerSide"> - <?dbhtml filename="DecidingWhatToChangeOnTheServerSide.html"?> - <title>What should I change on the server side?</title> - <para> The list of zones to be reRendered can be specified as EL expression. But - there is a question that must be specified more exactly. </para> - <para> The list of Ids is formed during beforePhase of RENDER_RESPONSE. Therefore, - in this case one can point reRender to the Set type Bean&apos;s property - and fill the Set during a tracking request. </para> - <para> It&apos;s the way to form a list of updatable areas dynamically. </para> - </section> - <section id="CheckSendingRequestConditions.CustomJavaScriptBeforeRequest.OnSubmitAttribute"> - <?dbhtml filename="CheckSendingRequestConditions.CustomJavaScriptBeforeRequest.OnSubmitAttribute.html"?> + <section id="DecidingWhatToChangeOnTheServerSide"> + <?dbhtml filename="DecidingWhatToChangeOnTheServerSide.html"?> + <title>What should I change on the server side?</title> + <para> The list of zones to be reRendered can be specified as EL expression. But + there is a question that must be specified more exactly. </para> + <para> The list of Ids is formed during beforePhase of RENDER_RESPONSE. + Therefore, in this case one can point reRender to the Set type + Bean&apos;s property and fill the Set during a tracking request. </para> + <para> It&apos;s the way to form a list of updatable areas dynamically. + </para> + </section> + <section + id="CheckSendingRequestConditions.CustomJavaScriptBeforeRequest.OnSubmitAttribute"> + <?dbhtml filename="CheckSendingRequestConditions.CustomJavaScriptBeforeRequest.OnSubmitAttribute.html"?> - <title>How to check sending request conditions? Custom JavaScript before request - &quot;OnSubmit&quot; attribute.</title> - <para> To check on the client some terms of request sending, the <emphasis> - <property>&quot;onSubmit&quot;</property> - </emphasis>&quot; attribute is added to all components, which may cause - the request. </para> - <para> - <emphasis role="bold">Example: </emphasis> - </para> - <programlisting role="XML"><![CDATA[<h:inputText id="i" value="#{beanText.kennung}"> + <title>How to check sending request conditions? Custom JavaScript before request + &quot;OnSubmit&quot; attribute.</title> + <para> To check on the client some terms of request sending, the <emphasis> + <property>&quot;onSubmit&quot;</property> + </emphasis>&quot; attribute is added to all components, which may + cause the request. </para> + <para> + <emphasis role="bold">Example: </emphasis> + </para> + <programlisting role="XML"><![CDATA[<h:inputText id="i" value="#{beanText.kennung}"> <a4j:support event="onfocus" onsubmit="doSomething();" reRender="panelToReRender"/> </h:inputText>]]></programlisting> - <para> So in this case - &quot;<code>doSomething()&quot;</code> - function is executed before the Ajax request. </para> - <para> Besides, if this function returns &quot;false&quot;, Ajax request - isn&apos;t fired. </para> - <note> - <title>Note:</title> - <para>Behavior of our <emphasis> + <para> So in this case &quot;<code>doSomething()&quot;</code> function + is executed before the Ajax request. </para> + <para> Besides, if this function returns &quot;false&quot;, Ajax request + isn&apos;t fired. </para> + <note> + <title>Note:</title> + <para>Behavior of our <emphasis> + <property>&quot;onsubmit&quot;</property> + </emphasis>slightly differs from the standard one. Do not + return &quot;true&quot; if you want to fire the + request - because + <code>&lt;xxx&gt;&lt;a4j:support + event=&quot;onclick&quot; + onsubmit=&quot;return + true;&quot;&gt;</code> is transformed into + <code>&lt;xxx onclick=&quot;return true; + A4J.Submit(.... );&quot; &gt;</code> and + the request isn&apos;t fired also in this case (but the + standard event processing fired). You must only return + &quot;false&quot; if your conditions + weren&apos;t completed or perform some actions (if + needed) without any returns in case you need to fire it. + </para> + </note> + </section> + <section id="onCompleteAttribute.DifferencesAfterRelease1.0"> + <?dbhtml filename="onCompleteAttribute.DifferencesAfterRelease1.0.html"?> + <title> What is differences of &quot;onCompelete&quot; attribute after + release 1.0?</title> + <para> To avoid differences with other JavaScript attributes, a function + placement in a JavaScript call is changed, instead of simple inserting + of attribute content (<code>..oncomplete + :anotherFunction(this)..</code>), it places (<code>oncomplete: + function(){anotherFunction(this);}..</code>) in anonymous + function, to allow put &quot;chain&quot; of statements in + attribute. </para> + <para> Since, <emphasis> + <property>&quot;this&quot;</property> + </emphasis> keyword will point to a parameters map instead of a + control element as it was before. You may use + <code>document.findElementById()</code>to get references to + this object after a request is processed as when a page is updated in + Ajax you will have reference to a control, removed from a DOM tree. </para> + <para> Or, if you are sure that your element is not updated, you can add <emphasis> <property>&quot;onsubmit&quot;</property> - </emphasis>slightly differs from the standard one. Do not return &quot;true&quot; if you want to fire the request - because <code>&lt;xxx&gt;&lt;a4j:support - event=&quot;onclick&quot; - onsubmit=&quot;return - true;&quot;&gt;</code> is transformed into <code>&lt;xxx onclick=&quot;return - true; A4J.Submit(.... );&quot; &gt;</code> and the request - isn&apos;t fired also in this case (but the standard event - processing fired). You must only return &quot;false&quot; if your conditions weren&apos;t completed or perform - some actions (if needed) without any returns in case you need to - fire it. </para> - </note> - </section> - <section id="onCompleteAttribute.DifferencesAfterRelease1.0"> - <?dbhtml filename="onCompleteAttribute.DifferencesAfterRelease1.0.html"?> - <title> What is differences of &quot;onCompelete&quot; attribute after - release 1.0?</title> - <para> To avoid differences with other JavaScript attributes, a function placement - in a JavaScript call is changed, instead of simple inserting of attribute - content (<code>..oncomplete :anotherFunction(this)..</code>), it places (<code>oncomplete: - function(){anotherFunction(this);}..</code>) in anonymous function, to allow put - &quot;chain&quot; of statements in attribute. </para> - <para> Since, <emphasis> - <property>&quot;this&quot;</property> - </emphasis> keyword will point to a parameters map instead of a control - element as it was before. You may use <code>document.findElementById()</code>to get references to this object after a request is processed as - when a page is updated in Ajax you will have reference to a control, removed - from a DOM tree. </para> - <para> Or, if you are sure that your element is not updated, you can add <emphasis> - <property>&quot;onsubmit&quot;</property> - </emphasis> in <emphasis role="bold"> - <property>&lt;a4j:support&gt;</property> - </emphasis> (or onclick in <emphasis role="bold"> - <property>&lt;a4j:commandLink/Button&gt;</property> - </emphasis>) to place reference to known variable (<code>&lt;a4j:commandLink onclick="var myControl=this;" + </emphasis> in <emphasis role="bold"> + <property>&lt;a4j:support&gt;</property> + </emphasis> (or onclick in <emphasis role="bold"> + <property>&lt;a4j:commandLink/Button&gt;</property> + </emphasis>) to place reference to known variable + (<code>&lt;a4j:commandLink onclick="var myControl=this;" oncomplete="anotherFunction(myControl)"/&gt;</code>). </para> - <tip> - <title>Tip:</title> - <para>The onComplete syntax now is:</para> - <programlisting role="XML"> + <tip> + <title>Tip:</title> + <para>The onComplete syntax now is:</para> + <programlisting role="XML"> <![CDATA[<someAjaxActionComponent ...oncomplete="myFunc(req,event,data)".../>]]> </programlisting> - <para> where the <code>event</code> is a variable where the JS event - copy that fires the request is placed into. One may use it to get - the element instead of this. and <code>data</code> is a - variable that contains deserialized value from the - <emphasis><property>&quot;data&quot;</property></emphasis> attribute. </para> - </tip> - </section> - <section id="InvokeOnComponentUsingWithJSF1.2"> - <?dbhtml filename="InvokeOnComponentUsingWithJSF1.2.html"?> - <title>Is it possible to use InvokeOnComponent with JSF 1.2?</title> - <para> RichFaces currently does not use <emphasis>invokeOnComponent</emphasis> - because of the 2 reasons: </para> - <itemizedlist> - <listitem> Compatibility with JSF 1.1 and MyFaces applications is kept, due - to a big amount of code used in corporate applications. </listitem> - <listitem> - <emphasis> InvokeOnComponent</emphasis> works with already known - clientId, and works fine for communication between widget and backed - component, or updates content of already rendered component. But - there are some troubles to use this method for more complex - use-cases implemented in RichFaces, as there is a choice for - updatable components in application logic, where it&apos;s - necessary to navigate in a components tree by the native id, with + <para> where the <code>event</code> is a variable where the JS event + copy that fires the request is placed into. One may use it + to get the element instead of this. and <code>data</code> is + a variable that contains deserialized value from the <emphasis> + <property>&quot;data&quot;</property> + </emphasis> attribute. </para> + </tip> + </section> + <section id="InvokeOnComponentUsingWithJSF1.2"> + <?dbhtml filename="InvokeOnComponentUsingWithJSF1.2.html"?> + <title>Is it possible to use InvokeOnComponent with JSF 1.2?</title> + <para> RichFaces currently does not use <emphasis>invokeOnComponent</emphasis> + because of the 2 reasons: </para> + <itemizedlist> + <listitem> Compatibility with JSF 1.1 and MyFaces applications is + kept, due to a big amount of code used in corporate + applications. </listitem> + <listitem> + <emphasis> InvokeOnComponent</emphasis> works with already + known clientId, and works fine for communication between + widget and backed component, or updates content of already + rendered component. But there are some troubles to use this + method for more complex use-cases implemented in RichFaces, + as there is a choice for updatable components in application + logic, where it&apos;s necessary to navigate in a + components tree by the native id, with <code>findComponent()</code> methods. </listitem> - </itemizedlist> - <para> Thus, for example, only entire dataTable can be updated in response (but all - Ajax core action components inside table work properly). </para> - </section> - <!--<section id="RegionsInDataTables"> + </itemizedlist> + <para> Thus, for example, only entire dataTable can be updated in response (but + all Ajax core action components inside table work properly). </para> + </section> + <!--<section id="RegionsInDataTables"> <?dbhtml filename="RegionsInDataTables.html"?> <title>Regions in Data Tables</title> <para>The regions in Data Tables aren&apos;t supported now, but the feature will be implemented in a new Ajax4jsf version for JSF 1.2.</para> </section>--> - <section id="keepAliveComponentGeneratesException"> - <?dbhtml filename="keepAliveComponentGeneratesException.html"?> - <title>How to avoid generating exception for &lt;a4j:keepAlive&gt; - component?</title> - <para>To avoid exception, don&apos;t forget that the component stores beans in - serialized view, but your bean should implement <code>java.io.Serializable</code>.</para> - </section> + <section id="keepAliveComponentGeneratesException"> + <?dbhtml filename="keepAliveComponentGeneratesException.html"?> + <title>How to avoid generating exception for &lt;a4j:keepAlive&gt; + component?</title> + <para>To avoid exception, don&apos;t forget that the component stores beans + in serialized view, but your bean should implement + <code>java.io.Serializable</code>.</para> + </section> - <section id="AFormIsNotSubmittedOrASetterIsNotCalledAfterAJAXrequest"> - <?dbhtml filename="AFormIsNotSubmittedOrASetterIsNotCalledAfterAJAXrequest.html"?> - <title>Why form isn&apos;t submitted or setter isn&apos;t called after AJAX - request?</title> - <para>This situation could happen because of conversion/validation errors on form - submission. In order to verify this, it&apos;s necessary to place this - updating via an Ajax error message inside a form:</para> + <section id="AFormIsNotSubmittedOrASetterIsNotCalledAfterAJAXrequest"> + <?dbhtml filename="AFormIsNotSubmittedOrASetterIsNotCalledAfterAJAXrequest.html"?> + <title>Why form isn&apos;t submitted or setter isn&apos;t called after + AJAX request?</title> + <para>This situation could happen because of conversion/validation errors on + form submission. In order to verify this, it&apos;s necessary to + place this updating via an Ajax error message inside a form:</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[<a4j:outputPanel ajaxRendered="true"> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[<a4j:outputPanel ajaxRendered="true"> <h:messages/> </a4j:outpurPanel>]]></programlisting> - </section> + </section> - <section id="DelayedRenderZone"> - <?dbhtml filename="DelayedRenderZone.html"?> - <title>How to create &quot;a4j delayed render zone&quot;?</title> - <para>The <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> component has - a <emphasis><property>&quot;requestDelay&quot;</property></emphasis> attribute where you can define the delay.</para> - <para>More information about this problem could be found on the <ulink - url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... - >Ajax4Jsf Users Forum.</ulink> - </para> - </section> + <section id="DelayedRenderZone"> + <?dbhtml filename="DelayedRenderZone.html"?> + <title>How to create &quot;a4j delayed render zone&quot;?</title> + <para>The <emphasis role="bold"> + <property>&lt;a4j:support&gt;</property> + </emphasis> component has a <emphasis> + <property>&quot;requestDelay&quot;</property> + </emphasis> attribute where you can define the delay.</para> + <para>More information about this problem could be found on the <ulink + url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... + >Ajax4Jsf Users Forum.</ulink> + </para> + </section> - <section id="HowToStopPoll"> - <?dbhtml filename="HowToStopPoll.html"?> - <title>How to stop &lt;a4j:poll&gt;?</title> - <para>More information about this problem could be found on the <ulink - url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... - >Ajax4Jsf Users Forum. </ulink> - </para> - </section> + <section id="HowToStopPoll"> + <?dbhtml filename="HowToStopPoll.html"?> + <title>How to stop &lt;a4j:poll&gt;?</title> + <para>More information about this problem could be found on the <ulink + url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... + >Ajax4Jsf Users Forum. </ulink> + </para> + </section> - <section id="IgnoreDupResponsesAndRequestDelay"> - <?dbhtml filename="IgnoreDupResponsesAndRequestDelay.html"?> + <section id="IgnoreDupResponsesAndRequestDelay"> + <?dbhtml filename="IgnoreDupResponsesAndRequestDelay.html"?> - <title>How to use IgnoreDupResponses and requestDelay?</title> - <para>The <emphasis> - <property>&quot;IgnoreDupResponses&quot;</property> - </emphasis> attribute appeared from 1.0.4 RC1 version and is used on the - client for response ignoring after an Ajax request if a newer request has - been already sent. <para> The additional information could be found <ulink - url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... - >here</ulink>. </para> - <emphasis> - <property>&quot;RequestDelay&quot;</property> - </emphasis> attribute also defines the client behavior. It sets the time - delay, after which another request could be sent, all other requests are - taken away from a queue except the last one. </para> - </section> + <title>How to use IgnoreDupResponses and requestDelay?</title> + <para>The <emphasis> + <property>&quot;IgnoreDupResponses&quot;</property> + </emphasis> attribute appeared from 1.0.4 RC1 version and is used on + the client for response ignoring after an Ajax request if a newer + request has been already sent. <para> The additional information could + be found <ulink + url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... + >here</ulink>. </para> + <emphasis> + <property>&quot;RequestDelay&quot;</property> + </emphasis> attribute also defines the client behavior. It sets the + time delay, after which another request could be sent, all other + requests are taken away from a queue except the last one. </para> + </section> - <section id="RefreshImage"> - <?dbhtml filename="RefreshImage.html"?> - <title>How to refresh an image using &lt;a4j:support&gt; component?</title> - <para>More information about this problem could be found on the <ulink - url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... - >Ajax4Jsf Users Forum. </ulink> - </para> - </section> + <section id="RefreshImage"> + <?dbhtml filename="RefreshImage.html"?> + <title>How to refresh an image using &lt;a4j:support&gt; component?</title> + <para>More information about this problem could be found on the <ulink + url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... + >Ajax4Jsf Users Forum. </ulink> + </para> + </section> - <section id="EventQueueUsage"> - <?dbhtml filename="EventQueueUsage.html"?> - <title>How to use &quot;EventQueue&quot; attribute?</title> - <para>The <emphasis> - <property>&quot;EventQueue&quot;</property> - </emphasis> attribute defines the query name where the requests are saved - before their sending to the server. The queue is created for redundant - requests deleting during frequent events, which call several requests - forming one after another. The queue cuts redundant requests and send only - the last one. The queue is created in any case and named on default, the - attribute usage only re-defines this name. </para> - </section> + <section id="EventQueueUsage"> + <?dbhtml filename="EventQueueUsage.html"?> + <title>How to use &quot;EventQueue&quot; attribute?</title> + <para>The <emphasis> + <property>&quot;EventQueue&quot;</property> + </emphasis> attribute defines the query name where the requests are + saved before their sending to the server. The queue is created for + redundant requests deleting during frequent events, which call several + requests forming one after another. The queue cuts redundant requests + and send only the last one. The queue is created in any case and named + on default, the attribute usage only re-defines this name. </para> + </section> - <section id="PageRequiredOrNot"> - <?dbhtml filename="PageRequiredOrNot.html"?> - <title>Is &lt;a4j:page&gt; component required or not?</title> - <para> - <emphasis role="bold"><property>&lt;4j:page&gt;</property></emphasis> is a component used - for solving of incompatibility problems in early Ajax4jsf and MyFaces - versions. The component encodes the full html page structure. </para> - <para>More information about this problem could be found on the <ulink - url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... - >Ajax4Jsf Users Forum. </ulink> - </para> - </section> + <section id="PageRequiredOrNot"> + <?dbhtml filename="PageRequiredOrNot.html"?> + <title>Is &lt;a4j:page&gt; component required or not?</title> + <para> + <emphasis role="bold"> + <property>&lt;4j:page&gt;</property> + </emphasis> is a component used for solving of incompatibility + problems in early Ajax4jsf and MyFaces versions. The component encodes + the full html page structure. </para> + <para>More information about this problem could be found on the <ulink + url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... + >Ajax4Jsf Users Forum. </ulink> + </para> + </section> - <section id="SeveralStatusOnPage"> - <?dbhtml filename="SeveralStatusOnPage.html"?> - <title>Can I have several &lt;a4j:status&gt; components on one page?</title> - <para>Yes, you can. More information about this problem could be found on the <ulink - url="http://livedemo.exadel.com/richfaces-demo/richfaces/status.jsf?... - >JBoss RichFaces Online Demos</ulink>. </para> - </section> + <section id="SeveralStatusOnPage"> + <?dbhtml filename="SeveralStatusOnPage.html"?> + <title>Can I have several &lt;a4j:status&gt; components on one page?</title> + <para>Yes, you can. More information about this problem could be found on the + <ulink + url="http://livedemo.exadel.com/richfaces-demo/richfaces/status.jsf?... + >JBoss RichFaces Online Demos</ulink>. </para> + </section> - <section id="SomeProblemsWithRendering"> - <?dbhtml filename="SomeProblemsWithRendering.html"?> - <title>Can I use &lt;a4j:region&gt; within &lt;a4j:repeat&gt;?</title> - <para> - <emphasis role="bold"><property>&lt;a4j:region&gt;</property></emphasis> can&apos;t - work inside iteration components like <emphasis role="bold" - ><property>&lt;h:dataTable&gt;</property></emphasis> and <emphasis role="bold" - ><property>&lt;a4j:repeat&gt;</property></emphasis>. </para> - <para>The details could be found <ulink - url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... - >here. </ulink> - </para> - </section> + <section id="SomeProblemsWithRendering"> + <?dbhtml filename="SomeProblemsWithRendering.html"?> + <title>Can I use &lt;a4j:region&gt; within &lt;a4j:repeat&gt;?</title> + <para> + <emphasis role="bold"> + <property>&lt;a4j:region&gt;</property> + </emphasis> can&apos;t work inside iteration components like + <emphasis role="bold"> + <property>&lt;h:dataTable&gt;</property> + </emphasis> and <emphasis role="bold"> + <property>&lt;a4j:repeat&gt;</property> + </emphasis>. </para> + <para>The details could be found <ulink + url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... + >here. </ulink> + </para> + </section> - <section id="CustomAjaxRequest"> - <?dbhtml filename="CustomAjaxRequest.html"?> - <title>Why custom Ajax request does not work?</title> - <para>More information about this problem could be found on the <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >Ajax4Jsf Users Forum.</ulink> - </para> - </section> + <section id="CustomAjaxRequest"> + <?dbhtml filename="CustomAjaxRequest.html"?> + <title>Why custom Ajax request does not work?</title> + <para>More information about this problem could be found on the <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >Ajax4Jsf Users Forum.</ulink> + </para> + </section> - <section id="RerederingSingleDataTableColumn"> - <?dbhtml filename="RerederingSingleDataTableColumn.html"?> - <title>How to reRender single dataTable column?</title> - <para>More information about this problem could be found on the <ulink - url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... - >Ajax4Jsf Users Forum. </ulink> - </para> - </section> + <section id="RerederingSingleDataTableColumn"> + <?dbhtml filename="RerederingSingleDataTableColumn.html"?> + <title>How to reRender single dataTable column?</title> + <para>More information about this problem could be found on the <ulink + url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... + >Ajax4Jsf Users Forum. </ulink> + </para> + </section> - <section id="DisableSkins"> - <?dbhtml filename="DisableSkins.html"?> - <title>How to disable skinability?</title> - <para>There is possibility to use special skin with name "plain". It doesn't have - any parameters. It's necessary for embedding RichFaces components into - existing projecst which have its own styles.</para> - <para>For information you can see discussion about this problem on the <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >Ajax4Jsf Users Forum. </ulink> - </para> - </section> + <section id="DisableSkins"> + <?dbhtml filename="DisableSkins.html"?> + <title>How to disable skinability?</title> + <para>There is possibility to use special skin with name "plain". It doesn't + have any parameters. It's necessary for embedding RichFaces components + into existing projecst which have its own styles.</para> + <para>For information you can see discussion about this problem on the <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >Ajax4Jsf Users Forum. </ulink> + </para> + </section> - <section id="reRenderingfailed"> - <?dbhtml filename="reRenderingfailed.html"?> - <title>Why does reRendering fail? Hide/Show components using rendered.</title> - <para> During &quot;show/hide&quot; functionality implementation the main - error happens because of the &quot;reRender&quot; attribute of some - Ajax core Action Component is set on a component that depends on rendered - properties, i.e. a component that is to be hidden/rendered is tried to be - updated. The problem is that if <code>rendered=&quot;false&quot;</code> in this - moment, the component isn&apos;t in the DOM tree and can&apos;t be - updated because of the general limitations described in the Ajax Processing - chapter. </para> - <para>The correct variant of functionality implantation:</para> + <section id="reRenderingfailed"> + <?dbhtml filename="reRenderingfailed.html"?> + <title>Why does reRendering fail? Hide/Show components using rendered.</title> + <para> During &quot;show/hide&quot; functionality implementation the + main error happens because of the &quot;reRender&quot; + attribute of some Ajax core Action Component is set on a component + that depends on rendered properties, i.e. a component that is to be + hidden/rendered is tried to be updated. The problem is that if + <code>rendered=&quot;false&quot;</code> in this + moment, the component isn&apos;t in the DOM tree and + can&apos;t be updated because of the general limitations described + in the Ajax Processing chapter. </para> + <para>The correct variant of functionality implantation:</para> - <orderedlist> - <listitem> - <para>With the rendered attribute wrap the component that is to be - hidden or rendered on Ajax in a wrapper component (e.g. - <emphasis role="bold"><property>&lt;a4j:outputPanel&gt;</property></emphasis>)</para> - </listitem> + <orderedlist> + <listitem> + <para>With the rendered attribute wrap the component that is + to be hidden or rendered on Ajax in a wrapper + component (e.g. <emphasis role="bold"> + <property>&lt;a4j:outputPanel&gt;</property> + </emphasis>)</para> + </listitem> - <listitem> - <para>Set reRender of an Ajax core Action component on this wrapper - component instead of the component itself.</para> - </listitem> - </orderedlist> + <listitem> + <para>Set reRender of an Ajax core Action component on this + wrapper component instead of the component + itself.</para> + </listitem> + </orderedlist> - <para> - <emphasis role="bold">Example:</emphasis> - </para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> - <programlisting role="XML"><![CDATA[... + <programlisting role="XML"><![CDATA[... <a4j:outputPanel id="panel"> <h:panelGroup rendered="#{bean.rendered}"> <!--Some nested content to be hidden/shown depending on bean.rendered --> @@ -1099,64 +1174,66 @@ ... ]]></programlisting> - <para>In this case the wrapper component always presents in the DOM tree and its - inner content could be updated dynamically on AJAX.</para> - </section> + <para>In this case the wrapper component always presents in the DOM tree and its + inner content could be updated dynamically on AJAX.</para> + </section> - <section id="PreventDupRerenderingPoll"> - <?dbhtml filename="PreventDupRerenderingPoll.html"?> - <title>How to prevent duplicate reRendering when using &lt;a4j:poll&gt;?</title> - <para>For information you can see discussion about this problem on the <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >Ajax4Jsf Users Forum. </ulink> - </para> - </section> + <section id="PreventDupRerenderingPoll"> + <?dbhtml filename="PreventDupRerenderingPoll.html"?> + <title>How to prevent duplicate reRendering when using &lt;a4j:poll&gt;?</title> + <para>For information you can see discussion about this problem on the <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >Ajax4Jsf Users Forum. </ulink> + </para> + </section> - <section id="JSCallPropblemsInInclude"> - <?dbhtml filename="JSCallPropblemsInInclude.html"?> - <title>Why does JavaScript call don&apos;t work in &lt;a4j:include&gt;?</title> - <para>More information about this problem could be found on the <ulink - url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... - >Ajax4Jsf Users Forum. </ulink> - </para> - </section> + <section id="JSCallPropblemsInInclude"> + <?dbhtml filename="JSCallPropblemsInInclude.html"?> + <title>Why does JavaScript call don&apos;t work in + &lt;a4j:include&gt;?</title> + <para>More information about this problem could be found on the <ulink + url="http://jboss.com/index.html?module=bb&amp;op=viewtopic&... + >Ajax4Jsf Users Forum. </ulink> + </para> + </section> - <section id="IncludeAndNavRules"> - <?dbhtml filename="IncludeAndNavRules.html"?> - <title>How to use &lt;a4j:include&gt; and navigation rules?</title> - <para>For information you can see discussion about this problem on the <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >Ajax4Jsf Users Forum. </ulink> - </para> - </section> + <section id="IncludeAndNavRules"> + <?dbhtml filename="IncludeAndNavRules.html"?> + <title>How to use &lt;a4j:include&gt; and navigation rules?</title> + <para>For information you can see discussion about this problem on the <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + >Ajax4Jsf Users Forum. </ulink> + </para> + </section> - <section id="ResourceNotRegisteredException"> - <?dbhtml filename="ResourceNotRegisteredException.html"?> - <title>What does ResourceNotRegistered Exception mean?</title> + <section id="ResourceNotRegisteredException"> + <?dbhtml filename="ResourceNotRegisteredException.html"?> + <title>What does ResourceNotRegistered Exception mean?</title> - <para>RichFaces registers its resources (scripts, images) after an application is - accessed and then accesses it via a generated URL. During an application - development when a developer constantly updates it on the server, it could - happen that RichFaces re-registers its resources after every server restart - and a browser tries to access them via cashed URL.</para> + <para>RichFaces registers its resources (scripts, images) after an application + is accessed and then accesses it via a generated URL. During an + application development when a developer constantly updates it on the + server, it could happen that RichFaces re-registers its resources + after every server restart and a browser tries to access them via + cashed URL.</para> - <para>The problem is solved with browser cash update (e.g. CTRL+F5).</para> - </section> + <para>The problem is solved with browser cash update (e.g. CTRL+F5).</para> + </section> - <section id="RerenderingPartPage"> - <?dbhtml filename="RerenderingPartPage.html"?> - <title>How to reRender only particular row(s) of table?</title> - <!--para> If you use dataTable then you may use <emphasis> + <section id="RerenderingPartPage"> + <?dbhtml filename="RerenderingPartPage.html"?> + <title>How to reRender only particular row(s) of table?</title> + <!--para> If you use dataTable then you may use <emphasis> <property>&quot;ajaxKeys&quot;</property> </emphasis> attribute to bind the rowKeys to be reRendered there. After you need to point reRender on the specific rows. </para--> - <para><emphasis> - <property>&quot;ajaxKeys&quot;</property> - </emphasis> attribute defines strings that are updated after an Ajax - request. It provides possibility to update several child components - separately without updating the whole page.</para> + <para><emphasis> + <property>&quot;ajaxKeys&quot;</property> + </emphasis> attribute defines strings that are updated after an Ajax + request. It provides possibility to update several child components + separately without updating the whole page.</para> - <programlisting role="XML"><![CDATA[... + <programlisting role="XML"><![CDATA[... <a4j:poll intervall="1000" action="#{repeater.action}" reRender="text"> <table> <tbody> @@ -1172,24 +1249,24 @@ </a4j:poll> ... ]]></programlisting> - </section> - <section id="RowSelectionInScrollableDataTable"> - <?dbhtml filename="RowSelectionInScrollableDataTable.html"?> - <title>How to get row selection in scrollableDataTable using one and multi-selection - rows mode?</title> - <para>In order to get row selection in scrollableDataTable using <property>one and - multi-selection rows mode</property> you should use the <emphasis> - <property>&quot;selection&quot;</property> - </emphasis> attribute. </para> - <para>In the following example when user submits the form current collection of - objects selected by user is placed in the object's property. Then on - complete action the <emphasis role="bold"> - <property>&lt;rich:modalPanel&gt;</property> - </emphasis> with selected data will be shown.</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... + </section> + <section id="RowSelectionInScrollableDataTable"> + <?dbhtml filename="RowSelectionInScrollableDataTable.html"?> + <title>How to get row selection in scrollableDataTable using one and + multi-selection rows mode?</title> + <para>In order to get row selection in scrollableDataTable using <property>one + and multi-selection rows mode</property> you should use the <emphasis> + <property>&quot;selection&quot;</property> + </emphasis> attribute. </para> + <para>In the following example when user submits the form current collection of + objects selected by user is placed in the object's property. Then on + complete action the <emphasis role="bold"> + <property>&lt;rich:modalPanel&gt;</property> + </emphasis> with selected data will be shown.</para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <h:form> <rich:spacer height="30" /> <rich:scrollableDataTable rowKeyVar="rkv" frozenColCount="1" height="200px" @@ -1249,17 +1326,19 @@ </rich:dataTable> </rich:modalPanel> ...]]></programlisting> - <para>In order to build this application, you can create a managed bean like this - one. Function <code>takeSelection()</code> fills the array <code>selectedCars</code> with the data, - got from the <property>selection</property>. Function <code>getSelectedCars()</code> - returns the array <code>selectedCars</code>, which is - used for filling <emphasis role="bold"> - <property>&lt;rich:dataTable&gt;</property> - </emphasis> with selected row/rows data.</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="JAVA"><![CDATA[... + <para>In order to build this application, you can create a managed bean like + this one. Function <code>takeSelection()</code> fills the array + <code>selectedCars</code> with the data, got from the + <property>selection</property>. Function + <code>getSelectedCars()</code> returns the array + <code>selectedCars</code>, which is used for filling + <emphasis role="bold"> + <property>&lt;rich:dataTable&gt;</property> + </emphasis> with selected row/rows data.</para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="JAVA"><![CDATA[... public class DataTableScrollerBean { private SimpleSelection selection = new SimpleSelection(); private ArrayList<DemoInventoryItem> selectedCars = new ArrayList<DemoInventoryItem>(); @@ -1289,12 +1368,12 @@ } } ...]]></programlisting> - <para>Some additional information about usage of <property>one and multi-selection - rows mode</property> can be found <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >here</ulink>.</para> - </section> - <!-- <section id="RowSelectionInDataTable"> + <para>Some additional information about usage of <property>one and + multi-selection rows mode</property> can be found <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... + + </section> + <!-- <section id="RowSelectionInDataTable"> <?dbhtml filename="RowSelectionInDataTable.html"?> <title>How to show a row of a dataTable on a modal panel?</title> <para>In order to get <property>a row selection in DataTable using </property> you should use the <emphasis> @@ -1439,23 +1518,25 @@ url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... </section> --> - - <section id="ScrollableDataTableDragAndDrop"> - <?dbhtml filename="ScrollableDataTableDragAndDrop.html"?> - <title>How to select several rows in a scrollableDataTable and Drag-and-Drop them on dataTable?</title> - <para> - How to get row selection in scrollableDataTable using <property>one and multi-selection rows mode</property> - you could see the section <link linkend="RowSelectionInScrollableDataTable">above</link>. - </para> - <para> - In order to perform Drag-and-Drop of selected columns on a dataTable you could use - <emphasis role="bold"><property>&lt;rich:dragSupport&gt;</property></emphasis> and <emphasis role="bold"><property>&lt;rich:dropSupport&gt;</property></emphasis> - components as it is shown in the example below. - </para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... + + <section id="ScrollableDataTableDragAndDrop"> + <?dbhtml filename="ScrollableDataTableDragAndDrop.html"?> + <title>How to select several rows in a scrollableDataTable and Drag-and-Drop + them on dataTable?</title> + <para> How to get row selection in scrollableDataTable using <property>one and + multi-selection rows mode</property> you could see the + section <link linkend="RowSelectionInScrollableDataTable" + >above</link>. </para> + <para> In order to perform Drag-and-Drop of selected columns on a dataTable you + could use <emphasis role="bold"> + <property>&lt;rich:dragSupport&gt;</property> + </emphasis> and <emphasis role="bold"> + <property>&lt;rich:dropSupport&gt;</property> + </emphasis> components as it is shown in the example below. </para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <rich:scrollableDataTable rowKeyVar="rkv" frozenColCount="1" height="400px" width="700px" id="carList" rows="40" columnClasses="col" value="#{dataTableScrollerBean.allCars}" var="category" sortMode="single" selection="#{dataTableScrollerBean.selection}"> <rich:column id="make"> @@ -1538,9 +1619,12 @@ </rich:dataTable> </rich:panel> ...]]></programlisting> - <para>This is the page from <ulink url="http://livedemo.exadel.com/richfaces-demo/richfaces/scrollableD... LiveDemo</ulink> site and also uses beans from RichFaces LiveDemo site. - Only one method is added where the dropped selection is stored:</para> - <programlisting role="JAVA"><![CDATA[... + <para>This is the page from <ulink + url="http://livedemo.exadel.com/richfaces-demo/richfaces/scrollableD... + >RichFaces LiveDemo</ulink> site and also uses beans from + RichFaces LiveDemo site. Only one method is added where the dropped + selection is stored:</para> + <programlisting role="JAVA"><![CDATA[... public void dropListener(DropEvent event) { System.out.println("Drop Listener Fired"); getDroppedCars().clear(); @@ -1550,26 +1634,35 @@ getDroppedCars().add(getAllCars().get(key.intValue())); } } -...]]></programlisting> - </section> - - <section id="SimpleTogglePanelPanelMenuState"> - <?dbhtml filename="SimpleTogglePanelPanelMenuState.html"?> - <title>How to save the state of &lt;rich:simpleTogglePanel&gt;?</title> - <para> - In order to save the state (exapnd/collapse) of the <emphasis role="bold"><property>&lt;rich:simpleTogglePanel&gt;</property></emphasis> component - you could use <emphasis><property>&quot;opened&quot;</property></emphasis> attribute responsible for keeping a panel state - and <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> binded to <emphasis><property>&quot;onexpand&quot;</property></emphasis> and <emphasis><property>&quot;oncollapse&quot;</property></emphasis> events. - </para> - <para> - In the following example when you click on the toggle icon <emphasis role="bold"><property>&lt;rich:simpleTogglePanel&gt;</property></emphasis> appears and current state displays on - <emphasis role="bold"><property>&lt;rich:modalPanel&gt;</property></emphasis>. - This state is remembered between page views. - </para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> -<programlisting role="XML"><![CDATA[... +...]]></programlisting> + </section> + + <section id="SimpleTogglePanelPanelMenuState"> + <?dbhtml filename="SimpleTogglePanelPanelMenuState.html"?> + <title>How to save the state of &lt;rich:simpleTogglePanel&gt;?</title> + <para> In order to save the state (exapnd/collapse) of the <emphasis role="bold"> + <property>&lt;rich:simpleTogglePanel&gt;</property> + </emphasis> component you could use <emphasis> + <property>&quot;opened&quot;</property> + </emphasis> attribute responsible for keeping a panel state and + <emphasis role="bold"> + <property>&lt;a4j:support&gt;</property> + </emphasis> binded to <emphasis> + <property>&quot;onexpand&quot;</property> + </emphasis> and <emphasis> + <property>&quot;oncollapse&quot;</property> + </emphasis> events. </para> + <para> In the following example when you click on the toggle icon <emphasis + role="bold"> + <property>&lt;rich:simpleTogglePanel&gt;</property> + </emphasis> appears and current state displays on <emphasis + role="bold"> + <property>&lt;rich:modalPanel&gt;</property> + </emphasis>. This state is remembered between page views. </para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <rich:simpleTogglePanel id="toggleP" label="simpleTogglePanel" switchType="client" width="600px" opened="#{bean.state}"> <a4j:support event="onexpand" actionListener="#{bean.stateTrue}" reRender="repeater" oncomplete="Richfaces.showModalPanel('myFrom:panel')" /> <a4j:support event="oncollapse" actionListener="#{bean.stateFalse}" reRender="repeater" oncomplete="Richfaces.showModalPanel('myFrom:panel')" /> @@ -1595,14 +1688,13 @@ <h:outputText value="Expanded simpleTogglePanel: " style="font-weight:bold;" /> <h:outputText value="#{bean.state}" id="repeater" /> </rich:modalPanel> -...]]></programlisting> - <para> - In order to build this application, you can create a managed bean like this one. - </para> - <para id="beanState"> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... +...]]></programlisting> + <para> In order to build this application, you can create a managed bean like + this one. </para> + <para id="beanState"> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... public class bean { private boolean state = false; @@ -1623,26 +1715,36 @@ this.state = false; } } -...]]></programlisting> - </section> - - <section id="PanelMenuGroupState"> - <?dbhtml filename="PanelMenuGroupState.html"?> - <title>How to save the state of &lt;rich:panelMenuGroup&gt;?</title> - <para> - With the help of the <emphasis><property>&quot;expanded&quot;</property></emphasis> attribute - and <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> binded to <emphasis><property>&quot;onexpand&quot;</property></emphasis> and <emphasis><property>&quot;oncollapse&quot;</property></emphasis> events - you could keep the state (&quot;expand&quot;/&quot;collapse&quot;) of the <emphasis role="bold"><property>&lt;rich:panelMenuGroup&gt;</property></emphasis> component. - </para> - <para> - In the following example when you click on the toggle icon the <emphasis role="bold"><property>&lt;rich:panelMenuGroup&gt;</property></emphasis> - expands and current state displays on <emphasis role="bold"><property>&lt;rich:modalPanel&gt;</property></emphasis>. - This state is remembered between page views. - </para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... +...]]></programlisting> + </section> + + <section id="PanelMenuGroupState"> + <?dbhtml filename="PanelMenuGroupState.html"?> + <title>How to save the state of &lt;rich:panelMenuGroup&gt;?</title> + <para> With the help of the <emphasis> + <property>&quot;expanded&quot;</property> + </emphasis> attribute and <emphasis role="bold"> + <property>&lt;a4j:support&gt;</property> + </emphasis> binded to <emphasis> + <property>&quot;onexpand&quot;</property> + </emphasis> and <emphasis> + <property>&quot;oncollapse&quot;</property> + </emphasis> events you could keep the state + (&quot;expand&quot;/&quot;collapse&quot;) of the + <emphasis role="bold"> + <property>&lt;rich:panelMenuGroup&gt;</property> + </emphasis> component. </para> + <para> In the following example when you click on the toggle icon the <emphasis + role="bold"> + <property>&lt;rich:panelMenuGroup&gt;</property> + </emphasis> expands and current state displays on <emphasis + role="bold"> + <property>&lt;rich:modalPanel&gt;</property> + </emphasis>. This state is remembered between page views. </para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <h:form id="myFrom"> <rich:panelMenu expandMode="ajax" iconExpandedTopGroup="chevronUp" iconCollapsedTopGroup="chevronDown"> <rich:panelMenuGroup label="Group 1" expanded="#{bean.state}"> @@ -1664,24 +1766,25 @@ <h:outputText value="#{bean.state}" id="repeater" /> </rich:modalPanel> </h:form> -...]]></programlisting> - <para> - In order to build this application, you can create a managed bean like <link linkend="beanState">this one</link>. - </para> - </section> - - - <section id="RowSelectionInDataTable"> - <?dbhtml filename="HighlightRowDataTable.html"?> - <title>How to highlight rows in a dataTable when the mouse is over?</title> - <para> - In order to highlight rows in a dataTable when the mouse is over you should use - <emphasis><property>&quot;onRowMouseOver&quot;</property></emphasis> and <emphasis><property>&quot;onRowMouseOut&quot;</property></emphasis> attributes. - </para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... +...]]></programlisting> + <para> In order to build this application, you can create a managed bean like + <link linkend="beanState">this one</link>. </para> + </section> + + + <section id="RowSelectionInDataTable"> + <?dbhtml filename="HighlightRowDataTable.html"?> + <title>How to highlight rows in a dataTable when the mouse is over?</title> + <para> In order to highlight rows in a dataTable when the mouse is over you + should use <emphasis> + <property>&quot;onRowMouseOver&quot;</property> + </emphasis> and <emphasis> + <property>&quot;onRowMouseOut&quot;</property> + </emphasis> attributes. </para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <h:form> <rich:dataTable onRowMouseOver="this.style.font = 'bold 20pt Arial'" onRowMouseOut="this.style.font='#{a4jSkin.tableFont}'" @@ -1767,17 +1870,19 @@ </rich:dataTable> </h:form> ...]]></programlisting> - - </section> - - <section id="OneRowSelectionInDataTable"> - <?dbhtml filename="HighlightRowDataTable.html"?> - <title>How to select one row of a dataTable by clicking on it, even if clicked in an inputText of this row?</title> - <para>In order to select one row of a dataTable by clicking on it you could use JavaScript function described below. </para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... + + </section> + + <section id="OneRowSelectionInDataTable"> + <?dbhtml filename="HighlightRowDataTable.html"?> + <title>How to select one row of a dataTable by clicking on it, even if clicked + in an inputText of this row?</title> + <para>In order to select one row of a dataTable by clicking on it you could use + JavaScript function described below. </para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <script type="text/javascript"> var oldRow; function changeColor(row) @@ -1791,11 +1896,17 @@ } </script> ...]]></programlisting> - <para>Then you could use <emphasis role="bold"><property>a4j:support</property></emphasis> with <emphasis><property>&quot;event&quot;</property></emphasis> and <emphasis><property>&quot;onsubmit&quot;</property></emphasis> attributes.</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... + <para>Then you could use <emphasis role="bold"> + <property>a4j:support</property> + </emphasis> with <emphasis> + <property>&quot;event&quot;</property> + </emphasis> and <emphasis> + <property>&quot;onsubmit&quot;</property> + </emphasis> attributes.</para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <h:form> <rich:dataTable cellpadding="0" cellspacing="0" width="700" border="0" var="record" value="#{report.expReport.records}"> @@ -1805,31 +1916,42 @@ ... </rich:dataTable> </h:form> -...]]></programlisting> - </section> - <section id="reRenderCells"> - <?dbhtml filename="reRenderCells.html"?> - <title>How to reRender table cells with &lt;a4j:support&gt;?</title> - <para>In order to reRender table cells with <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> - you should set exact <property>ids</property> values for every updatable components - and point this <property>id</property> to the <emphasis><property>&quot;reRender&quot;</property></emphasis> attribute.</para> - - <note> - <title>Note:</title> - <para>The value of <emphasis><property>&quot;reRender&quot;</property></emphasis> - attribute of the <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis> tag defines which part(s) - of our page is (are) to be updated. In this case, the only part of the page to update is the - <emphasis role="bold"><property>&lt;h:outputText&gt;</property></emphasis> tag because its <property>id</property> - value matches to the value of <emphasis><property>&quot;reRender&quot;</property></emphasis> - attribute. - As you see, it's not difficult to update multiple elements on the page, only list their <property>ids</property> as the value of - <emphasis><property>&quot;reRender&quot;</property></emphasis> - attribute .</para> - </note> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... +...]]></programlisting> + </section> + <section id="reRenderCells"> + <?dbhtml filename="reRenderCells.html"?> + <title>How to reRender table cells with &lt;a4j:support&gt;?</title> + <para>In order to reRender table cells with <emphasis role="bold"> + <property>&lt;a4j:support&gt;</property> + </emphasis> you should set exact <property>ids</property> values for + every updatable components and point this <property>id</property> to + the <emphasis> + <property>&quot;reRender&quot;</property> + </emphasis> attribute.</para> + + <note> + <title>Note:</title> + <para>The value of <emphasis> + <property>&quot;reRender&quot;</property> + </emphasis> attribute of the <emphasis role="bold"> + <property>&lt;a4j:support&gt;</property> + </emphasis> tag defines which part(s) of our page is (are) + to be updated. In this case, the only part of the page to + update is the <emphasis role="bold"> + <property>&lt;h:outputText&gt;</property> + </emphasis> tag because its <property>id</property> value + matches to the value of <emphasis> + <property>&quot;reRender&quot;</property> + </emphasis> attribute. As you see, it's not difficult to + update multiple elements on the page, only list their + <property>ids</property> as the value of <emphasis> + <property>&quot;reRender&quot;</property> + </emphasis> attribute .</para> + </note> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <rich:column> <f:facet name="header"> <h:outputText value="Input1"/> @@ -1850,10 +1972,13 @@ </f:facet> <h:outputText id="output1" value="#{entry.output1}"/> </rich:column> -...]]></programlisting> - <para>As it could be seen in the example above, the footer with <emphasis role="bold"><property>&lt;h:outputText&gt;</property></emphasis> reRenderes.</para> - </section> - <!--section> +...]]></programlisting> + <para>As it could be seen in the example above, the footer with <emphasis + role="bold"> + <property>&lt;h:outputText&gt;</property> + </emphasis> reRenderes.</para> + </section> + <!--section> <?dbhtml filename="HighlightRowDataTable.html"?> <title>How to use jsFunction with JSON?</title> <para>JsFunction and JSON can be used in many ways, for example:</para> @@ -1914,8 +2039,8 @@ <programlisting role="JAVA"><![CDATA[var jsonString = executeObjectCreation("test", "anotherParam"); var myObject = eval(jsonString); var name = myObject.name; -...]]></programlisting--> - <!--para>You can use jsFunction to call the jsonTest backing bean that generates some random data in a JSON-String. +...]]></programlisting--> + <!--para>You can use jsFunction to call the jsonTest backing bean that generates some random data in a JSON-String. That JSON-String is then passed to the updateFields method, which evaluates it and populates some html tags with its content. </para> <para> <emphasis role="bold">Example:</emphasis> @@ -2049,18 +2174,23 @@ jsonData = aJsonData; } } -...]]></programlisting--> - <!--/section--> - <section id="DinamicColumns"> - <?dbhtml filename="DinamicColumns.html"?> - <title>How to dynamic columns?</title> - <para>In order to create dynamic columns you could use the <emphasis role="bold"><property>&lt;rich:column&gt;</property></emphasis> component - with the<emphasis><property>&quot;rendered&quot;</property></emphasis> attribute. You should just set the value of defined dynamic cell to the - <emphasis><property>&quot;rendered&quot;</property></emphasis> attribute field.</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... +...]]></programlisting--> + <!--/section--> + <section id="DinamicColumns"> + <?dbhtml filename="DinamicColumns.html"?> + <title>How to dynamic columns?</title> + <para>In order to create dynamic columns you could use the <emphasis role="bold"> + <property>&lt;rich:column&gt;</property> + </emphasis> component with the<emphasis> + <property>&quot;rendered&quot;</property> + </emphasis> attribute. You should just set the value of defined + dynamic cell to the <emphasis> + <property>&quot;rendered&quot;</property> + </emphasis> attribute field.</para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <ui:composition template="/WEB-INF/layout/template.xhtml"> <ui:define name="body"> <h2>Table</h2> @@ -2103,12 +2233,12 @@ </ui:define> </ui:composition> ...]]></programlisting> - <para>In order to build this application, you can create a managed bean like this - one.</para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="JAVA"><![CDATA[ + <para>In order to build this application, you can create a managed bean like + this one.</para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="JAVA"><![CDATA[ public class TableBackingRendered implements Serializable { private static final long serialVersionUID = 1L; private Random rand = new Random(System.currentTimeMillis()); @@ -2149,8 +2279,8 @@ this.tableData = tableData; } } -...]]></programlisting> - <!--para>Another solution when you are dealing with a significant amount of rows, if you are using facelets you can use c:forEach (jslt).</para> +...]]></programlisting> + <!--para>Another solution when you are dealing with a significant amount of rows, if you are using facelets you can use c:forEach (jslt).</para> <para> <emphasis role="bold">Example:</emphasis> </para> @@ -2166,17 +2296,18 @@ <h:outputText value="#{rowCol.index?.cells.value}"/> </c:forEach> </rich:dataTable> -...]]></programlisting--> - </section> - <section id="Trinidad"> - <?dbhtml filename="Trinidad.html"?> - <title>RichFaces with Trinidad?</title> - <para>Here is a stripped down version of web.xml that integrates RichFaces and Trinidad.</para> - - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[ +...]]></programlisting--> + </section> + <section id="Trinidad"> + <?dbhtml filename="Trinidad.html"?> + <title>RichFaces with Trinidad?</title> + <para>Here is a stripped down version of web.xml that integrates RichFaces and + Trinidad.</para> + + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[ <?xml version="1.0" ?> <web-app xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_5.xsd" @@ -2291,44 +2422,47 @@ </welcome-file-list> </web-app> -]]></programlisting> - </section> - <section> - <?dbhtml filename="WhydoesJSScriptsconflict.html"?> - <title>Why does Java Script conflict?</title> - <para>Richfaces 3.1.3 uses 1.6.0 version of prototype.js script instead of 1.5.1 - that's been used for earlier versions. There are 2 prototype versions included - (the first included implicitly as a dependency of toggle panel components and - the second one included explicitly as a link). Versions conflict is the cause of the problem.</para> - <para>RichFaces 3.1.3 is bundled with the same ones as Prototype 1.6.0, Scriptaculous 1.8.0</para> - <para> - <emphasis role="bold">Example in web.xml::</emphasis> - </para> - <programlisting role="XML"><![CDATA[... +]]></programlisting> + </section> + <section> + <?dbhtml filename="WhydoesJSScriptsconflict.html"?> + <title>Why does Java Script conflict?</title> + <para>Richfaces 3.1.3 uses 1.6.0 version of prototype.js script instead of 1.5.1 + that's been used for earlier versions. There are 2 prototype versions + included (the first included implicitly as a dependency of toggle + panel components and the second one included explicitly as a link). + Versions conflict is the cause of the problem.</para> + <para>RichFaces 3.1.3 is bundled with the same ones as Prototype 1.6.0, + Scriptaculous 1.8.0</para> + <para> + <emphasis role="bold">Example in web.xml::</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <context-param> <param-name>org.richfaces.ExcludeScripts</param-name> <param-value>Prototype,Scriptaculous</param-value> </context-param> -...]]></programlisting> - <para>RichFaces components use Prototype very hard. In particular, some patches has been removed that are already included into 1.6.0. - Adding feature with exclusion makes it possible to use Prototype with version less than 1.6.0. This will break some of the components.</para> - - </section> - - <section id="fileUploadConf"> - <?dbhtml filename="FileUploadConf.html"?> - <title>&lt;rich:fileUpload&gt; with Seam</title> - <para> - The <emphasis role="bold"><property>&lt;rich:fileUpload&gt;</property></emphasis> component could work together with Seam framework. - </para> - <para> - Initialization parameters should be defined for Seam Filter in web.xml. - They will be automatically set up for Ajax4Jsf Filer by Seam framework on start up. - </para> - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... +...]]></programlisting> + <para>RichFaces components use Prototype very hard. In particular, some patches + has been removed that are already included into 1.6.0. Adding feature + with exclusion makes it possible to use Prototype with version less + than 1.6.0. This will break some of the components.</para> + + </section> + + <section id="fileUploadConf"> + <?dbhtml filename="FileUploadConf.html"?> + <title>&lt;rich:fileUpload&gt; with Seam</title> + <para> The <emphasis role="bold"> + <property>&lt;rich:fileUpload&gt;</property> + </emphasis> component could work together with Seam framework. </para> + <para> Initialization parameters should be defined for Seam Filter in web.xml. + They will be automatically set up for Ajax4Jsf Filer by Seam framework + on start up. </para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... <filter> <filter-name>Seam Filter</filter-name> <filter-class>org.jboss.seam.servlet.SeamFilter</filter-class> @@ -2341,53 +2475,141 @@ <param-value>200000</param-value> </init-param> </filter> -...]]></programlisting> - </section> - <section id="suggestionboxObjectSelection"> - <?dbhtml filename="suggestionboxObjectSelection.html"?> - <title>Optional object selection in &lt;rich:suggestionbox&gt;</title> - <para> - The <emphasis role="bold"><property>&lt;rich:suggestionbox&gt;</property></emphasis> component provides such feature as - object selection. In order to store selected items as objects and then get access to them you could use next scenario: - </para> - <itemizedlist> - <listitem> - <para> - Add <emphasis><property>&quot;usingSuggestObjects&quot;</property></emphasis> attribute with &quot;true&quot; value to - <emphasis role="bold"><property>&lt;rich:suggestionbox&gt;</property></emphasis> - </para> - </listitem> - <listitem> - <para> - Use <emphasis><property>&quot;onobjectchanged&quot;</property></emphasis> event attribute - to store objects currently selected - </para> - </listitem> - <listitem> - <para> - All selected objects are stored under <code>suggestion.SelectedItems</code> array. - Each array element contains of <code>text</code> and <code>object</code> properties. - So, you could iterate this array, get <property>not null objects</property> and then get the property you need. - </para> - </listitem> - </itemizedlist> - </section> - <section id="viewExpiredException"> - <?dbhtml filename="viewExpiredException.html"?> - <title>How to handle ViewExpiredException?</title> - <para> - As <property>RichFaces 3.1</property> is targeted at JSF 1.1, - you won&apos;t get <code>ViewExpiredExceptions</code> generated when using it with JSF 1.2. - This exception appears after session timeout. - </para> - <para> - Fortunately there is an easy workaround. Add to your web.xml: - </para> - <programlisting role="XML"><![CDATA[... +...]]></programlisting> + </section> + + <section id="richfileUploadforMyFaces" role="new"> + <?dbhtml filename="richfileUploadforMyFaces.html"?> + <title>How to configure &lt;rich:fileUpload&gt; for MyFaces framework</title> + <para> To make <emphasis role="bold"> + <property>&lt;rich:fileUpload&gt;</property> + </emphasis> component work properly with MyFaces framework, the + extentions filter for that framework should be defined in web.xml + file. </para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... +<!--Ajax filter definition--> +<filter> + <display-name>Ajax4jsf Filter</display-name> + <filter-name>ajax4jsf</filter-name> + <filter-class>org.ajax4jsf.Filter</filter-class> + <init-param> + <param-name>createTempFiles</param-name> + <param-value>true</param-value> + </init-param> +</filter> + +<!--Extensions filter definition--> +<filter> + <filter-name>extensionsFilter</filter-name> + <filter-class>org.apache.myfaces.webapp.filter.ExtensionsFilter</filter-class> + <init-param> + <description> + Set the size limit for uploaded files. Format: 10 - 10 bytes 10k - 10 KB 10m - 10 MB 1g - 1 GB + </description> + <param-name>uploadMaxFileSize</param-name> + <param-value>100m</param-value> + </init-param> + <init-param> + <description> + Set the threshold size - files below this limit are stored in memory, files above this limit are stored on disk. Format: 10 - 10 bytes 10k - 10 KB 10m - 10 MB 1g - 1 GB + </description> + <param-name>uploadThresholdSize</param-name> + <param-value>100k</param-value> + </init-param> +</filter> + +<!--Mapping Ajax filter on the faces servlet--> +<filter-mapping> + <filter-name>ajax4jsf</filter-name> + <servlet-name>Faces Servlet</servlet-name> + <dispatcher>REQUEST</dispatcher> + <dispatcher>FORWARD</dispatcher> + <dispatcher>INCLUDE</dispatcher> + <dispatcher>ERROR</dispatcher> +</filter-mapping> + +<!--Mapping MyfFaces extention filter on the faces servlet--> +<filter-mapping> + <filter-name>extensionsFilter</filter-name> + <servlet-name>Faces Servlet</servlet-name> +</filter-mapping> + +<!--Listener, that allows Jetty serving MyFaces applications--> +<listener> + <listener-class>org.apache.myfaces.webapp.StartupServletContextListener</listener-class> +</listener> + +<!--Faces servlet definition--> +<servlet> + <servlet-name>Faces Servlet</servlet-name> + <servlet-class>javax.faces.webapp.FacesServlet</servlet-class> + <load-on-startup>1</load-on-startup> +</servlet> + +<!--MappingFaces servlet on the *.jsf --> +<servlet-mapping> + <servlet-name>Faces Servlet</servlet-name> + <url-pattern>*.jsf</url-pattern> +</servlet-mapping> +...]]></programlisting> + <para> Note, that definition and mapping of the extentions filter goes after + definition and mapping of ajax filter. This is a required condition to + make it work properly. Moreover, the extention filter should be mapped + on the faces servlet but not to *.jsf (!) to provide this sequence + work properly. </para> + </section> + + <section id="suggestionboxObjectSelection"> + <?dbhtml filename="suggestionboxObjectSelection.html"?> + <title>Optional object selection in &lt;rich:suggestionbox&gt;</title> + <para> The <emphasis role="bold"> + <property>&lt;rich:suggestionbox&gt;</property> + </emphasis> component provides such feature as object selection. In + order to store selected items as objects and then get access to them + you could use next scenario: </para> + <itemizedlist> + <listitem> + <para> Add <emphasis> + <property>&quot;usingSuggestObjects&quot;</property> + </emphasis> attribute with + &quot;true&quot; value to <emphasis + role="bold"> + <property>&lt;rich:suggestionbox&gt;</property> + </emphasis> + </para> + </listitem> + <listitem> + <para> Use <emphasis> + <property>&quot;onobjectchanged&quot;</property> + </emphasis> event attribute to store objects + currently selected </para> + </listitem> + <listitem> + <para> All selected objects are stored under + <code>suggestion.SelectedItems</code> + array. Each array element contains of + <code>text</code> and <code>object</code> + properties. So, you could iterate this array, get + <property>not null objects</property> + and then get the property you need. </para> + </listitem> + </itemizedlist> + </section> + <section id="viewExpiredException"> + <?dbhtml filename="viewExpiredException.html"?> + <title>How to handle ViewExpiredException?</title> + <para> As <property>RichFaces 3.1</property> is targeted at JSF 1.1, you + won&apos;t get <code>ViewExpiredExceptions</code> generated when + using it with JSF 1.2. This exception appears after session timeout. </para> + <para> Fortunately there is an easy workaround. Add to your web.xml: </para> + <programlisting role="XML"><![CDATA[... <context-param> <param-name>com.sun.faces.enableRestoreView11Compatibility</param-name> <param-value>true</param-value> </context-param> -...]]></programlisting> - </section> +...]]></programlisting> + </section> </chapter>