From richfaces-svn-commits at lists.jboss.org Wed Aug 13 07:42:12 2008 Content-Type: multipart/mixed; boundary="===============7781368606925743789==" MIME-Version: 1.0 From: richfaces-svn-commits at lists.jboss.org To: richfaces-svn-commits at lists.jboss.org Subject: [richfaces-svn-commits] JBoss Rich Faces SVN: r10062 - trunk/docs/faq/en/src/main/docbook/module. Date: Wed, 13 Aug 2008 07:42:12 -0400 Message-ID: --===============7781368606925743789== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable 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 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/docs/faq/en/src/main/docbook/module/RFCfaq.xml 2008-08-13 11:38:4= 7 UTC (rev 10061) +++ trunk/docs/faq/en/src/main/docbook/module/RFCfaq.xml 2008-08-13 11:42:1= 1 UTC (rev 10062) @@ -1,72 +1,74 @@ - - - - RichFaces - - - FAQ -
- - Where could I find additional information on RichFa= ces? - - Most important links for RichFaces can be found here. = - -
-
- - Where are binary/source distribution for RichFaces?= - = - - There are two places where you can find binary/sou= rce distribution: - - - JBoss RichFaces Downloads area whi= ch can be found here. - Source distribution you can see in= the richfaces-ui-3.2.1-src.zip. = - Binary stored in richfaces-u= i-3.2.1-bin.zip - - - If you use Maven, Maven knows the = place where all distributions are stored. - Actual links to the Maven reposito= ry can be found here - - - -
+ There are two places where you can find bina= ry/source distribution: + JBoss RichFaces Downloa= ds area which can be found + here. Source di= stribution you + can see in the + richfaces-ui-3.2.1= -src.zip. Binary + stored in richface= s-ui-3.2.1-bin.zip + + If you use Maven, Maven= knows the place where all + distributions are stored= . Actual links to the + Maven repository can be = found here + + + + = -
- - How to build RichFaces snapshot manually? - This wiki article helps you to find a= n answer. -
+
+ + How to build RichFaces snapshot manually?</titl= e> + <para>This <ulink + url=3D"http://labs.jboss.com/wiki/= HowToBuildRichFacesSnapshotManually" + > wiki article</ulink> helps you t= o find an answer.</para> + </section> = - <section> - <?dbhtml filename=3D"HowtobuildRichFacessnapshotmanually.h= tml"?> - <title>How to configure Maven for RichFaces - - - Download and install Maven if you ha= ve not it yet installed. - Follow the instruction at - http://maven.apache.org/do= wnload.html. - +
+ + How to configure Maven for RichFaces + + + Download and install Maven i= f you have not it yet + installed. Follow the in= struction at + http://maven.apache.org/= download.html. + = - - Open - <Maven-Root>/conf/settings.x= ml - file to edit + + Open <Maven-Root>/conf= /settings.xml file + to edit = - Add into the <profile> - section: - Add into the <profi= le> + section: + RichFaces @@ -128,103 +130,113 @@ ]]> - Add into the - <activeProfiles> section: - RichFaces]]> + Add into the + <activeProfiles= > + section: + RichFaces]]> = - + = - -
+ +
= -
- - What is the structure of RichFaces SVN repository?<= /title> - <para>RichFaces repository structure overview can be found= <ulink - url=3D"http://labs.jboss.com/wiki/RichFace= sRepositoryStructureOverview" - >here</ulink>.</para> - </section> + <section> + <?dbhtml filename=3D"WhatstructureofRichFacesSVNreposi= toryis.html"?> + <title>What is the structure of RichFaces SVN reposito= ry? + RichFaces repository structure overview can be f= ound here. +
= -
- - How to build richfaces-samples applications? - How to build and how to use richfaces-samples applic= ations in Eclipse is - described here. -
+
+ + How to build richfaces-samples applications?</t= itle> + <para>How to build and how to use richfaces-samples ap= plications in Eclipse is + described <ulink + url=3D"http://labs.jboss.com/wiki/= RichFacesRepositoryStructureOverview" + >here</ulink>.</para> + </section> = - <section> - <?dbhtml filename=3D"IstheredemoforRichFacescomponents.htm= l"?> - <title>Where could I find a demo for RichFaces components?= - Online demo Web applications that show the most impo= rtant functionality of - RichFaces components are available here. - War file of a nightly build can be found here. - Source Code (SVN) can be found here. - See also how to prevent richfaces-demo deployment = failed. -
+
+ + Where could I find a demo for RichFaces compone= nts? + Online demo Web applications that show the most = important functionality of + RichFaces components are available here. + War file of a nightly build can be found here. + Source Code (SVN) can be found here. + See also how to prevent richfaces-demo dep= loyment + failed. +
= -
- - How to use Skinnability? - Here is an article that explains = the Skinnability basics. - For information you can also see discussion about t= his problem on the RichFaces Users Forum - Also, the effect of predefined skins on the applicat= ion whole look-and-feel - could be seen here. -
+
+ + How to use Skinnability? + Here is an article that e= xplains the Skinnability + basics. + For information you can also see discussion abo= ut this problem on the + RichFaces Users Forum + Also, the effect of predefined skins on the appl= ication whole + look-and-feel could be seen here. +
= -
- - Why does a problem with prototypes in RichFaces 3.1= .0 happen? The - Prototype.Browser() function can't be found.<= /title> - <para>RichFaces 3.1.0 has been released with the latest Pr= ototype 1.5.1.1. The - conflict happens because on your page an older ver= sion of prototypes that - can be added from Tomahawk 1.1.6 is used. See the = solution for the problem - <ulink - url=3D"http://www.jboss.com/index.html?mod= ule=3Dbb&op=3Dviewtopic&t=3D118526&postdays=3D0&postorder= =3Dasc&start=3D0" - >here.</ulink></para> - </section> + <section> + <?dbhtml filename=3D"Whythereisaproblemwithprototypes.= html"?> + <title>Why does a problem with prototypes in RichFaces= 3.1.0 happen? The + Prototype.Browser() function can't be f= ound. + RichFaces 3.1.0 has been released with the lates= t Prototype 1.5.1.1. The + conflict happens because on your page an old= er version of prototypes + that can be added from Tomahawk 1.1.6 is use= d. See the solution for + the problem here. +
= -
- - Why RichFaces library contains <rich:dataTable&g= t; component, - though there is the standard <h:dataTable>?<= /title> - <para>The article about <emphasis role=3D"bold" - ><property><rich:dataTable></property></emph= asis> flexibility can be found <ulink - url=3D"http://labs.jboss.com/wiki/RichFace= sArticleDataTable" - >here</ulink>.</para> - <para>Source code (SVN) could be found <ulink - url=3D"http://anonsvn.jboss.org/repos/rich= faces/trunk/samples/richfaces-art-datatable/" - >here</ulink>.</para> - <para> Online demo for a Web application is available <uli= nk - url=3D" http://livedemo.exadel.com/richfac= es-art-datatable/" - >here</ulink>.</para> - </section> + <section> + <?dbhtml filename=3D"WhyRichFaceslibrarycondataTableco= mp.html"?> + <title>Why RichFaces library contains <rich:dataTab= le> component, + though there is the standard <h:dataTable= >? + The article about + <rich:dataTable> + flexibility can be found here. + Source code (SVN) could be found here. + Online demo for a Web application is available = here. +
= -
- - How to organize wizards using the <rich:modalPan= el> component? - It's necessary to put <a4j:include><= /emphasis> inside the <rich:modalPane= l> and perform - navigation inside it, as it's shown in the ex= ample below: +
+ + How to organize wizards using the <rich:moda= lPanel> + component? + It's necessary to put + <a4j:include> + inside the + <rich:modalPanel><= /property> + and perform navigation inside it= , as it's shown + in the example below: = - - Example: - - + Example: + + Show Modal Panel @@ -265,75 +277,80 @@ ... = ]]> - The discussion about <a4j:include> and navigation rules can be found on - the Ajax Users Forum. -
+ The discussion about + <a4j:include> + and navigation rules can be foun= d on the Ajax Users Forum. +
= -
- - How to prevent modalPanel from closing when the val= idation inside fails? - Examples of validation in <rich:modalPanel> could be found in the - Wiki - article and on the RichFaces Users Forum. -
+
+ + How to prevent modalPanel from closing when the= validation inside fails? + Examples of validation in + <rich:modalPanel><= /property> + could be found in the Wiki + article and on the RichFaces Users Forum. +
= -
- - Why when I use suggestionBox inside the modalPanel = content the popup - suggestion list doesn't show since it is behi= nd the modalPanel. - To solve this problem you should use the latest vers= ions of RichFaces. - Most important links for RichFaces can be found here. +
+ + Why when I use suggestionBox inside the modalPa= nel content the popup + suggestion list doesn't show since it i= s behind the + modalPanel. + To solve this problem you should use the latest = versions of RichFaces. + Most important links for RichFaces can be found= here. = -
+
= -
- - Does RichFaces work with facelets? - Main demo of - RichFaces is a facelets based application. Full Fa= celets support is one of - the main features. Hence, the answer is yes. -
+
+ + Does RichFaces work with facelets? + Main demo + of RichFaces is a facelets based application= . Full Facelets support is + one of the main features. Hence, the answer = is yes. +
= -
- - Is it possible to create dynamic menu using <ric= h:dropDownMenu> - component? - <rich:dropDownM= enu> is a - standard JSF component. Thus, creation of the menu= dynamically from the Java - Script code is the same as for any other jsf compo= nent. - For more information follow the link. -
+
+ + Is it possible to create dynamic menu using + <rich:dropDownMenu> component? + + <rich:dropDownMenu>= ; + is a standard JSF component. Thu= s, creation of the menu + dynamically from the Java Script code is the= same as for any other jsf + component. + For more information follow the link. +
= -
- - Is it possible to customize the look of datascrolle= r (the forward/back - buttons) and replace them with an images? - The answer is yes. - Component provides two controllers groups for switch= ing: - - Page numbers for switching onto a partic= ular page - The controls of fast switching: "fi= rst", - "last", "next", - "previous", "fastforward&qu= ot;, - "fastrewind" - - The controls of fast switching are created adding th= e facets component with - the corresponding name: +
+ + Is it possible to customize the look of datascr= oller (the forward/back + buttons) and replace them with an images?</t= itle> + <para>The answer is yes. </para> + <para>Component provides two controllers groups for sw= itching:</para> + <itemizedlist> + <listitem>Page numbers for switching onto a = particular page</listitem> + <listitem>The controls of fast switching: &q= uot;first", + "last", "next", + "previous", + "fastforward", + "fastrewind"</listitem> + </itemizedlist> + <para>The controls of fast switching are created addin= g the facets component + with the corresponding name:</para> = - <para> - <emphasis role=3D"bold">Example:</emphasis> - </para> - <programlisting role=3D"XML"><![CDATA[ ... + <para> + <emphasis role=3D"bold">Example:</emphasis> + </para> + <programlisting role=3D"XML"><![CDATA[ ... <rich:datascroller for=3D"table" maxPages=3D"10"> <f:facet name=3D"first"> <h:outputText value=3D"First"/> @@ -344,23 +361,31 @@ </rich:datascroller> ... ]]></programlisting> - <para> There are also facets used to create the disabled s= tates: - <emphasis><property>"first_disabled"</property><= /emphasis>, <emphasis><property>"last_disabled"</property></empha= sis>, - <emphasis><property>"next_disabled"</property></= emphasis>, <emphasis><property>"previous_disabled"</property></em= phasis>, - <emphasis><property>"fastforward_disabled"</pro= perty></emphasis>, - <emphasis><property>"fastrewind_disabled"</prop= erty></emphasis>. </para> - </section> + <para> There are also facets used to create the disabl= ed states: <emphasis> + <property>"first_disabled&quo= t;</property> + </emphasis>, <emphasis> + <property>"last_disabled"= ;</property> + </emphasis>, <emphasis> + <property>"next_disabled"= ;</property> + </emphasis>, <emphasis> + <property>"previous_disabled&= quot;</property> + </emphasis>, <emphasis> + <property>"fastforward_disabl= ed"</property> + </emphasis>, <emphasis> + <property>"fastrewind_disable= d"</property> + </emphasis>. </para> + </section> = - <section> - <?dbhtml filename=3D"Howtoredirecttoanotherpage.html"?> - <title>How to place simple links inside menu? - If you want to navigate outside, when application us= es an external URL, you - should use the following approach: +
+ + How to place simple links inside menu? + If you want to navigate outside, when applicatio= n uses an external URL, + you should use the following approach: = - - Example: - - + Example: + + = ... ... ]]> - Also online demo <rich:dropDownMenu> component is available here. -
+ Also online demo + <rich:dropDownMenu>= ; + component is available here. +
= -
- - Can I use dropDownMenu as context menu? - The <rich:dropD= ownMenu> is - designed keeping in mind that it should not be use= d for a contextMenu - purpose. We have a <rich:contextMenu> component in the TODO list. - However, it is not schedule for the nearest versio= ns. -
+
+ + Can I use dropDownMenu as context menu? + The + <rich:dropDownMenu>= ; + is designed keeping in mind that= it should not be used for + a contextMenu purpose. We have a + <rich:contextMenu>= + component in the TODO list. Howe= ver, it is not schedule + for the nearest versions. +
= -
- - How to pass own parameters during a modalPanel open= ing or closing? - You can pass your parameters during modalPanel open= ing or closing. This - passing could be performed in the following way: <= /para> +
+ + How to pass own parameters during a modalPanel = opening or closing? + You can pass your parameters during modalPanel = opening or closing. This + passing could be performed in the following = way: = - - Example: - - - Thus, except the standard modalPanel parameters you= can pass any of your own - parameters. -
+ + Example: + + + Thus, except the standard modalPanel parameters= you can pass any of your + own parameters. +
= -
- - How to add a simple link to the tree node? - Simple code is placed below: +
+ + How to add a simple link to the tree node?</tit= le> + <para>Simple code is placed below:</para> = - <para> - <emphasis role=3D"bold">Example:</emphasis> - </para> - <programlisting role=3D"XML"><![CDATA[... + <para> + <emphasis role=3D"bold">Example:</emphasis> + </para> + <programlisting role=3D"XML"><![CDATA[... <rich:tree ...> = ... <rich:treeNode submitMode=3D"none" = @@ -424,25 +452,25 @@ </rich:tree ...> = ... ]]></programlisting> - </section> + </section> = - <section> - <?dbhtml filename=3D"Isitpossibletoplacetabsvertically.htm= l"?> - <title>Is it possible to place tabs upright in the tabPane= l? - It's not possible to place tabs upright in the = tabPanel. For this - purporse use togglePanel. Toggle controls can be p= laced anywhere in the - layout. -
+
+ + Is it possible to place tabs upright in the tab= Panel? + It's not possible to place tabs upright in = the tabPanel. For this + purporse use togglePanel. Toggle controls ca= n be placed anywhere in + the layout. +
= -
- - How to get a commandButton working within the modal= Panel? - Simple code is placed below: +
+ + How to get a commandButton working within the m= odalPanel? + Simple code is placed below: = - - Example: - - + Example: + + = = = @@ -456,27 +484,38 @@ ... ]]> - - - Note:Two rules are im= portant for modalPanel: - modalPanel must ha= ve its own form if it has form - elements (input or/and com= mand components) inside - (as it was shown in the ex= ample above) - modalPanel must no= t be included into the form (on - any level up) if it has th= e form inside. - - -
+ + + Note: + Two rules are important for = modalPanel: + + + modalPanel must ha= ve its own form + if it has form elements = (input + or/and command component= s) + inside (as it was shown = in the + example above) + + + modalPanel must no= t be included + into the form (on any le= vel + up) if it has the form + inside. + + + + +
= -
- - How to define the currently selected tab? - Simple code is placed below: +
+ + How to define the currently selected tab?</titl= e> + <para> Simple code is placed below:</para> = - <para> - <emphasis role=3D"bold">Example:</emphasis> - </para> - <programlisting role=3D"XML"><![CDATA[... + <para> + <emphasis role=3D"bold">Example:</emphasis> + </para> + <programlisting role=3D"XML"><![CDATA[... <rich:tabPanel selectedTab=3D"t2"> <rich:tab label=3D"tab 1" name=3D"t1"> <h:outputText value=3D"tab 1" /> @@ -490,36 +529,36 @@ </rich:tabPanel> ... ]]></programlisting> - </section> + </section> = - <section> - <?dbhtml filename=3D"Howtoremembercurrentselectedtab.html"= ?> - <title>How to remember the current selected tab? - For necessary information you can see discussion ab= out this problem on the - RichFaces Users Forum. -
+
+ + How to remember the current selected tab?</titl= e> + <para> For necessary information you can see discussio= n about this problem on + the <ulink + url=3D"http://www.jboss.com/index.= html?module=3Dbb&op=3Dviewtopic&t=3D111761" + >RichFaces Users Forum</ulink>.</p= ara> + </section> = - <section> - <?dbhtml filename=3D"Howtonavigatefromonetabtoanother.html= "?> - <title>How to navigate from one tab to another using butto= ns (apart from tabPanel - functionality)? - For necessary information you can see RichFaces Users Forum. -
+
+ + How to navigate from one tab to another using b= uttons (apart from + tabPanel functionality)? + For necessary information you can see RichFaces Users Forum. +
= -
- - How to retrieve the current value from the inputNum= berSlider? - To catch the value of the inputNumberSlider from the= JavaScript, use the - following approach: +
+ + How to retrieve the current value from the inpu= tNumberSlider? + To catch the value of the inputNumberSlider from= the JavaScript, use the + following approach: = - - Example: - - + Example: + + ... ]]> -
+
= -
- - How to apply skins to the standard input components= ? - The answer could be found here. -
+
+ + How to apply skins to the standard input compon= ents? + The answer could be found here. +
= -
- - Is there a way to capture the rowdata of dataTable = and subTable? - For necessary information you can see discussion ab= out this problem on the - RichFaces Users Forum -
+
+ + Is there a way to capture the rowdata of dataTa= ble and subTable? + For necessary information you can see discussio= n about this problem on + the RichFaces Users Forum +
= -
- - Is it possible to use datascroller without its tabl= e border and styles (to - show only links)? - It' necessary to redefine rich* classes for ex= ample like this: +
+ + Is it possible to use datascroller without its = table border and styles + (to show only links)? + It' necessary to redefine rich* classes fo= r example like this: = - - Example: - - + Example: + + -
+
= -
- - How to use subTable in combination with dataTable?<= /title> - <para>The answer could be found <ulink - url=3D"http://www.jboss.com/index.html?mod= ule=3Dbb&op=3Dviewtopic&p=3D4059044#4059044" - >here</ulink>.</para> - </section> + <section> + <?dbhtml filename=3D"subTableincombinationwithdataTabl= e.html"?> + <title>How to use subTable in combination with dataTab= le? + The answer could be found here. +
= -
- - How to do correct pagination using datascroller (lo= ad a part of data from - database)? - The answer could be found on the RichFaces Users Forum. - How to use <ric= h:dataTable> and - <rich= :dataScroller> - in a context of Extended Data Model see here. -
+
+ + How to do correct pagination using datascroller= (load a part of data from + database)? + The answer could be found on the RichFaces Users Forum. + How to use + <rich:dataTable> + and + <rich:dataScroller>= ; + in a context of Extended Data Mo= del see here. +
= -
- - How to make html scrollbars in modalPanel? - The answer could be found on the RichFaces Users For= um: - - - http://www.jboss.com/index.html?m= odule=3Dbb&op=3Dviewtopic&p=3D4062877#4062877 - - - http://www.jboss.com/index.html?m= odule=3Dbb&op=3Dviewtopic&t=3D105412 - - +
+ + How to make html scrollbars in modalPanel?</tit= le> + <para>The answer could be found on the RichFaces Users= Forum:</para> + <itemizedlist> + <listitem> + <ulink + url=3D"http://www.jboss.= com/index.html?module=3Dbb&op=3Dviewtopic&p=3D4062877#4062877" + >http://www.jboss.com/in= dex.html?module=3Dbb&op=3Dviewtopic&p=3D4062877#4062877</ulink> + </listitem> + <listitem> + <ulink + url=3D"http://www.jboss.= com/index.html?module=3Dbb&op=3Dviewtopic&t=3D105412" + >http://www.jboss.com/in= dex.html?module=3Dbb&op=3Dviewtopic&t=3D105412</ulink> + </listitem> + </itemizedlist> = - </section> + </section> = - <section> - <?dbhtml filename=3D"HowtoExpand/CollapseTreeNodesfromcode= .html"?> - <title>How to expand/collapse tree nodes from code? - The answer could be found here. -
+
+ + How to expand/collapse tree nodes from code?</t= itle> + <para>The answer could be found <ulink + url=3D"http://labs.jboss.com/wiki/= ExpandCollapseTreeNodes" + >here</ulink>.</para> + </section> = - <section> - <?dbhtml filename=3D"HowtouseJavaScriptAPI.html"?> - <title>How to use JavaScript API? - The simple code is placed below: - - Example: - - + + How to use JavaScript API? + The simple code is placed below: + + Example: + + @@ -646,71 +687,74 @@ ... ]]> -
+
= -
- - How to load the Scriptaculous library? - To load the whole Scriptaculous library shipped with= RichFaces use <a4j:loadScript> tag. +
+ + How to load the Scriptaculous library? + To load the whole Scriptaculous library shipped = with RichFaces use + <a4j:loadScript> tag. = - - Example: - - + Example: + + ... ]]> - Thus, this command allows loading an integrated ver= sion of the library that - includes all existing scriptaculous files except u= nittest.js. - If you don't want to load the whole library, b= ut only the particular - file, for example, effect.js, use the= following line: - - Example: - - Thus, this command allows loading an integrated= version of the library + that includes all existing scriptaculous fil= es except unittest.js. + If you don't want to load the whole librar= y, but only the + particular file, for example, effect.j= s, use the + following line: + + Example: + + ... ]]> - Remember, it does not make sense to load the partic= ular file if you already - load the whole version. + Remember, it does not make sense to load the pa= rticular file if you + already load the whole version. = - For more information see RichFaces Users Forum. -
+ For more information see RichFaces Users Forum. +
= -
- - How to avoid a problem with text wrapping in <ri= ch:tab> in - Internet Explorer 7? - A problem with tab height occurs in IE 7. The tab he= ight is correct in Firefox - and IE 6. This is IE's 7 bug. As a temporary = solution you can try - to change doctype declaration from: - ]]> - to: - ]]> - See also http://jira.jboss.com/jira/browse/RF-1011= . -
+
+ + How to avoid a problem with text wrapping in &l= t;rich:tab> in + Internet Explorer 7? + A problem with tab height occurs in IE 7. The ta= b height is correct in + Firefox and IE 6. This is IE's 7 bug. A= s a temporary solution + you can try to change doctype declaration fr= om: + ]]> + to: + ]]> + See also http://jira.jboss.com/jira/browse= /RF-1011. +
= -
- - How to save <rich:effect> status? - <rich:effect>= ; component has - several callback methods such as beforeStart, afte= rFinish. You can use them - to save the status. - See also core effects in scriptaculous. -
+
+ + How to save <rich:effect> status? + + <rich:effect> + component has several callback m= ethods such as + beforeStart, afterFinish. You can use them t= o save the status. + See also core effects in scriptacu= lous. +
= -
- - How to send an additional parameter to server worki= ng with - <rich:suggestionbox>? - An example is placed below: - + + How to send an additional parameter to server w= orking with + <rich:suggestionbox>? + An example is placed below: + = @@ -724,30 +768,31 @@ ... ]]> - In the example "onselect" event is used - for sending selected value to the server. It'= s also possible to - pass additional fields of selected object (which d= on't belong to - "fetchvalue" - attribute.) -
+ In the example "onselect" event is + used for sending selected value to the serve= r. It's also + possible to pass additional fields of select= ed object (which + don't belong to + "fetchvalue" + attribute.) +
= -
- - How to set <rich:dataTable> border to 0px?</t= itle> - <para>Add the following code to your css file:</para> - <programlisting role=3D"CSS"><![CDATA[... + <section> + <?dbhtml filename=3D"Howtosetrich:dataTableborder.html= "?> + <title>How to set <rich:dataTable> border to 0px= ? + Add the following code to your css file: + -
+
= -
- - How to create <rich:suggestionBox> dynamicall= y? - This is a working example: - + + How to create <rich:suggestionBox> dynami= cally? + This is a working example: + - See also RichFaces User Forum. -
+ See also RichFaces User Forum. +
= -
- - How to apply button label for <rich: calendar>= ;? - Necessary information could be found on the RichFaces User Forum. -
+
+ + How to apply button label for <rich: calenda= r>? + Necessary information could be found on the RichFaces User Forum. +
= = = -
- - What should I change on the server side? - The list of zones to be reRendered can be specified= as EL expression. But - there is a question that must be specified more ex= actly. - The list of Ids is formed during beforePhase of REN= DER_RESPONSE. Therefore, - in this case one can point reRender to the Set typ= e Bean's property - and fill the Set during a tracking request. - It's the way to form a list of updatable areas= dynamically. -
-
- +
+ + What should I change on the server side? + The list of zones to be reRendered can be speci= fied as EL expression. But + there is a question that must be specified m= ore exactly. + The list of Ids is formed during beforePhase of= RENDER_RESPONSE. + Therefore, in this case one can point reRend= er to the Set type + Bean's property and fill the Set during= a tracking request. + It's the way to form a list of updatable a= reas dynamically. + +
+
+ = - How to check sending request conditions? Custom Jav= aScript before request - "OnSubmit" attribute. - To check on the client some terms of request sendin= g, the - "onSubmit" - " attribute is added to all compon= ents, which may cause - the request. - - Example: - - + How to check sending request conditions? Custom= JavaScript before request + "OnSubmit" attribute. + To check on the client some terms of request se= nding, the + "onSubmit" + " attribute is added to all = components, which may + cause the request. + + Example: + + ]]> - So in this case - "doSomething()" - function is executed before the Ajax request. - Besides, if this function returns "false"= , Ajax request - isn't fired. - - Note: - Behavior of our + So in this case "doSomething()"= function + is executed before the Ajax request. + Besides, if this function returns "false&q= uot;, Ajax request + isn't fired. + + Note: + Behavior of our + "onsubmit= " + slightly differs from t= he standard one. Do not + return "true" if you wan= t to fire the + request - because + <xxx><a4j= :support + event=3D"onclick&qu= ot; + onsubmit=3D"return + true;"> is transfor= med into + <xxx onclick=3D= "return true; + A4J.Submit(.... );"= > and + the request isn't fired also = in this case (but the + standard event processing fired). = You must only return + "false" if your conditio= ns + weren't completed or perform = some actions (if + needed) without any returns in cas= e you need to fire it. + + +
+
+ + What is differences of "onCompelete"= attribute after + release 1.0? + To avoid differences with other JavaScript attr= ibutes, a function + placement in a JavaScript call is changed, i= nstead of simple inserting + of attribute content (..oncomplete + :anotherFunction(this)..), it places = (oncomplete: + function(){anotherFunction(this);}= ..) in anonymous + function, to allow put "chain" of = statements in + attribute. + Since, + "this" + keyword will point to a paramete= rs map instead of a + control element as it was before. You may use + document.findElementById()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, r= emoved from a DOM tree. + Or, if you are sure that your element is not up= dated, you can add "onsubmit" - slightly differs from the stand= ard one. Do not return "true" if you want to fire the request - b= ecause <xxx><a4j:support - event=3D"onclick" - onsubmit=3D"return - true;"> is transfor= med into <xxx onclick=3D"return - true; A4J.Submit(.... );" >= and the request - isn't fired also in this case (but th= e standard event - processing fired). You must only return &q= uot;false" if your conditions weren't completed or perform - some actions (if needed) without any retur= ns in case you need to - fire it. - -
-
- - What is differences of "onCompelete" att= ribute after - release 1.0? - To avoid differences with other JavaScript attribut= es, a function placement - in a JavaScript call is changed, instead of simple= inserting of attribute - content (..oncomplete :anotherFunction(this)= ..), it places (oncomplete: - function(){anotherFunction(this);}..) in an= onymous function, to allow put - "chain" of statements in attribute. - Since, - "this" - keyword will point to a parameters map= instead of a control - element as it was before. You may use docume= nt.findElementById()to get references to this object after a request= is processed as - when a page is updated in Ajax you will have refer= ence to a control, removed - from a DOM tree. - Or, if you are sure that your element is not update= d, you can add - "onsubmit" - in - <a4j:support> - (or onclick in - <a4j:commandLink/Button> - ) to place reference to known variable = (<a4j:commandLink onclick=3D"var myControl=3Dthis;" + in + <a4j:support> + (or onclick in + <a4j:commandLink/Butt= on> + ) to place reference to known var= iable + (<a4j:commandLink onclick= =3D"var myControl=3Dthis;" oncomplete=3D"anotherFunction(myCo= ntrol)"/>). - - Tip: - The onComplete syntax now is: - + + Tip: + The onComplete syntax now is: + ]]> - where the event 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 dat= a is a - variable that contains deserialized value = from the - "data" attribute. - -
-
- - Is it possible to use InvokeOnComponent with JSF 1.= 2? - RichFaces currently does not use invokeOn= Component - because of the 2 reasons: - - Compatibility with JSF 1.1 and MyFaces = applications is kept, due - to a big amount of code used in corporate = applications. - - InvokeOnComponent wo= rks with already known - clientId, and works fine for communication= between widget and backed - component, or updates content of already r= endered component. But - there are some troubles to use this method= for more complex - use-cases implemented in RichFaces, as the= re is a choice for - updatable components in application logic,= where it's - necessary to navigate in a components tree= by the native id, with + where the event is a var= iable where the JS event + copy that fires the request is pla= ced into. One may use it + to get the element instead of this= . and data is + a variable that contains deseriali= zed value from the + "data&quo= t; + attribute. + +
+
+ + Is it possible to use InvokeOnComponent with JS= F 1.2? + RichFaces currently does not use invo= keOnComponent + because of the 2 reasons: + + Compatibility with JSF 1.1 and My= Faces applications is + kept, due to a big amount of code = used in corporate + applications. + + InvokeOnComponent works with already + known clientId, and works fine for= communication between + widget and backed component, or up= dates 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's necessary t= o navigate in a + components tree by the native id, = with findComponent() metho= ds. - - Thus, for example, only entire dataTable can be upd= ated in response (but all - Ajax core action components inside table work prop= erly). -
- -
- - How to avoid generating exception for <a4j:keepA= live> - component? - To avoid exception, don't forget that the compo= nent stores beans in - serialized view, but your bean should implement java.io.Serializable. -
+
+ + How to avoid generating exception for <a4j:k= eepAlive> + component? + To avoid exception, don't forget that the c= omponent stores beans + in serialized view, but your bean should imp= lement + java.io.Serializable.= +
= -
- - Why form isn't submitted or setter isn't = called after AJAX - request? - This situation could happen because of conversion/va= lidation errors on form - submission. In order to verify this, it's nec= essary to place this - updating via an Ajax error message inside a form:<= /para> +
+ + Why form isn't submitted or setter isn&apo= s;t called after + AJAX request? + This situation could happen because of conversio= n/validation errors on + form submission. In order to verify this, it= 's necessary to + place this updating via an Ajax error messag= e inside a form: = - - Example: - - + + Example: + + ]]> -
+
= -
- - How to create "a4j delayed render zone"?<= /title> - <para>The <emphasis role=3D"bold"><property><a4j:suppor= t></property></emphasis> component has - a <emphasis><property>"requestDelay"</pr= operty></emphasis> attribute where you can define the delay.</para> - <para>More information about this problem could be found o= n the <ulink - url=3D"http://jboss.com/index.html?module= =3Dbb&op=3Dviewtopic&t=3D104969" - >Ajax4Jsf Users Forum.</ulink> - </para> - </section> + <section id=3D"DelayedRenderZone"> + <?dbhtml filename=3D"DelayedRenderZone.html"?> + <title>How to create "a4j delayed render zone&quo= t;? + The + <a4j:support> + component has a + "requestDelay"= + attribute where you can define t= he delay. + More information about this problem could be fou= nd on the Ajax4Jsf Users Forum. + +
= = -
- - How to stop <a4j:poll>? - More information about this problem could be found o= n the Ajax4Jsf Users Forum. - -
+
+ + How to stop <a4j:poll>? + More information about this problem could be fou= nd on the Ajax4Jsf Users Forum. + +
= -
- +
+ = - How to use IgnoreDupResponses and requestDelay?</ti= tle> - <para>The <emphasis> - <property>"IgnoreDupResponses"</= property> - </emphasis> attribute appeared from 1.0.4 RC1 vers= ion and is used on the - client for response ignoring after an Ajax request= if a newer request has - been already sent. <para> The additional informati= on could be found <ulink - url=3D"http://jboss.com/index.html= ?module=3Dbb&op=3Dviewtopic&t=3D105766" - >here</ulink>. </para> - <emphasis> - <property>"RequestDelay"</proper= ty> - </emphasis> attribute also defines the client beha= vior. 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. </par= a> - </section> + <title>How to use IgnoreDupResponses and requestDelay?= + The + "IgnoreDupResponses= " + attribute appeared from 1.0.4 RC= 1 version and is used on + the client for response ignoring after an Aj= ax request if a newer + request has been already sent. The ad= ditional information could + be found here. + + "RequestDelay"= + attribute also defines the clien= t behavior. It sets the + time delay, after which another request coul= d be sent, all other + requests are taken away from a queue except = the last one. +
= = -
- - How to refresh an image using <a4j:support> c= omponent? - More information about this problem could be found o= n the Ajax4Jsf Users Forum. - -
+
+ + How to refresh an image using <a4j:support&g= t; component? + More information about this problem could be fou= nd on the Ajax4Jsf Users Forum. + +
= -
- - How to use "EventQueue" attribute? - The - "EventQueue" - attribute defines the query name where= the requests are saved - before their sending to the server. The queue is c= reated for redundant - requests deleting during frequent events, which ca= ll several requests - forming one after another. The queue cuts redundan= t 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. -
+
+ + How to use "EventQueue" attribute?</t= itle> + <para>The <emphasis> + <property>"EventQueue"</= property> + </emphasis> attribute defines the query name= where the requests are + saved before their sending to the server. Th= e queue is created for + redundant requests deleting during frequent = events, which call several + requests forming one after another. The queu= e cuts redundant requests + and send only the last one. The queue is cre= ated in any case and named + on default, the attribute usage only re-defi= nes this name. </para> + </section> = - <section id=3D"PageRequiredOrNot"> - <?dbhtml filename=3D"PageRequiredOrNot.html"?> - <title>Is <a4j:page> component required or not?</tit= le> - <para> - <emphasis role=3D"bold"><property><4j:page><= /property></emphasis> is a component used - for solving of incompatibility problems in early A= jax4jsf and MyFaces - versions. The component encodes the full html page= structure. </para> - <para>More information about this problem could be found o= n the <ulink - url=3D"http://jboss.com/index.html?module= =3Dbb&op=3Dviewtopic&t=3D106849&postdays=3D0&postorder=3Das= c&start=3D0" - >Ajax4Jsf Users Forum. </ulink> - </para> - </section> + <section id=3D"PageRequiredOrNot"> + <?dbhtml filename=3D"PageRequiredOrNot.html"?> + <title>Is <a4j:page> component required or not?<= /title> + <para> + <emphasis role=3D"bold"> + <property><4j:page></propert= y> + </emphasis> is a component used for solving = of incompatibility + problems in early Ajax4jsf and MyFaces versi= ons. The component encodes + the full html page structure. </para> + <para>More information about this problem could be fou= nd on the <ulink + url=3D"http://jboss.com/index.html= ?module=3Dbb&op=3Dviewtopic&t=3D106849&postdays=3D0&postord= er=3Dasc&start=3D0" + >Ajax4Jsf Users Forum. </ulink> + </para> + </section> = - <section id=3D"SeveralStatusOnPage"> - <?dbhtml filename=3D"SeveralStatusOnPage.html"?> - <title>Can I have several <a4j:status> components on= one page? - Yes, you can. More information about this problem co= uld be found on the JBoss RichFaces Online Demos. -
+
+ + Can I have several <a4j:status> component= s on one page? + Yes, you can. More information about this proble= m could be found on the + JBoss RichFaces Online Demos. +
= -
- - Can I use <a4j:region> within <a4j:repeat&= gt;? - - <a4j:region&g= t; can't - work inside iteration components like <h:dataTable><= /emphasis> and <a4j:repeat>. - The details could be found here. - -
+
+ + Can I use <a4j:region> within <a4j:rep= eat>? + + + <a4j:region> + can't work inside iteration= components like + + <h:dataTable> + and + <a4j:repeat> + . + The details could be found here. + +
= -
- - Why custom Ajax request does not work? - More information about this problem could be found o= n the Ajax4Jsf Users Forum. - -
+
+ + Why custom Ajax request does not work? + More information about this problem could be fou= nd on the Ajax4Jsf Users Forum. + +
= = -
- - How to reRender single dataTable column? - More information about this problem could be found o= n the Ajax4Jsf Users Forum. - -
+
+ + How to reRender single dataTable column? + More information about this problem could be fou= nd on the Ajax4Jsf Users Forum. + +
= -
- - How to disable skinability? - There is possibility to use special skin with name "= plain". It doesn't have - any parameters. It's necessary for embedding RichF= aces components into - existing projecst which have its own styles. - For information you can see discussion about this pr= oblem on the Ajax4Jsf Users Forum. - -
+
+ + How to disable skinability? + There is possibility to use special skin with na= me "plain". It doesn't + have any parameters. It's necessary for embe= dding RichFaces components + into existing projecst which have its own st= yles. + For information you can see discussion about thi= s problem on the Ajax4Jsf Users Forum. + +
= -
- - Why does reRendering fail? Hide/Show components usi= ng rendered. - During "show/hide" functionality implemen= tation the main - error happens because of the "reRender" = attribute of some - Ajax core Action Component is set on a component t= hat depends on rendered - properties, i.e. a component that is to be hidden/= rendered is tried to be - updated. The problem is that if rendered=3D&= quot;false" in this - moment, the component isn't in the DOM tree a= nd can't be - updated because of the general limitations describ= ed in the Ajax Processing - chapter. - The correct variant of functionality implantation: +
+ + Why does reRendering fail? Hide/Show components= using rendered. + During "show/hide" functionality impl= ementation the + main error happens because of the "reRe= nder" + 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 + rendered=3D"false"= in this + moment, the component isn't in the DOM = tree and + can't be updated because of the general= limitations described + in the Ajax Processing chapter. + The correct variant of functionality implantatio= n: = - - - With the rendered attribute wrap the= component that is to be - hidden or rendered on Ajax in a wr= apper component (e.g. - = <a4j:outputPanel>) - + + + With the rendered attribute = wrap the component that is + to be hidden or rendered= on Ajax in a wrapper + component (e.g. + <a4j:output= Panel> + ) + = - - Set reRender of an Ajax core Action = component on this wrapper - component instead of the component= itself. - - + + Set reRender of an Ajax core= Action component on this + wrapper component instea= d of the component + itself. + + = - - Example: - + + Example: + = - = @@ -1099,64 +1174,66 @@ ... ]]> = - In this case the wrapper component always presents i= n the DOM tree and its - inner content could be updated dynamically on AJAX= . -
+ In this case the wrapper component always presen= ts in the DOM tree and its + inner content could be updated dynamically o= n AJAX. +
= -
- - How to prevent duplicate reRendering when using <= ;a4j:poll>? - For information you can see discussion about this pr= oblem on the Ajax4Jsf Users Forum. - -
+
+ + How to prevent duplicate reRendering when using= <a4j:poll>? + For information you can see discussion about thi= s problem on the Ajax4Jsf Users Forum. + +
= -
- - Why does JavaScript call don't work in <a4j= :include>? - More information about this problem could be found o= n the Ajax4Jsf Users Forum. - -
+
+ + Why does JavaScript call don't work in + <a4j:include>? + More information about this problem could be fou= nd on the Ajax4Jsf Users Forum. + +
= -
- - How to use <a4j:include> and navigation rules= ? - For information you can see discussion about this pr= oblem on the Ajax4Jsf Users Forum. - -
+
+ + How to use <a4j:include> and navigation r= ules? + For information you can see discussion about thi= s problem on the Ajax4Jsf Users Forum. + +
= -
- - What does ResourceNotRegistered Exception mean?</ti= tle> + <section id=3D"ResourceNotRegisteredException"> + <?dbhtml filename=3D"ResourceNotRegisteredException.ht= ml"?> + <title>What does ResourceNotRegistered Exception mean?= = - 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 a= fter every server restart - and a browser tries to access them via cashed URL.= + RichFaces registers its resources (scripts, imag= es) after an application + is accessed and then accesses it via a gener= ated URL. During an + application development when a developer con= stantly updates it on the + server, it could happen that RichFaces re-re= gisters its resources + after every server restart and a browser tri= es to access them via + cashed URL. = - The problem is solved with browser cash update (e.g.= CTRL+F5). -
+ The problem is solved with browser cash update (= e.g. CTRL+F5). +
= -
- - How to reRender only particular row(s) of table?</t= itle> - <!--para> If you use dataTable then you may use <emphasis> + <section id=3D"RerenderingPartPage"> + <?dbhtml filename=3D"RerenderingPartPage.html"?> + <title>How to reRender only particular row(s) of table= ? + - - "ajaxKeys" - attribute defines strings that are upd= ated after an Ajax - request. It provides possibility to update several= child components - separately without updating the whole page. + + "ajaxKeys" + attribute defines strings that a= re updated after an Ajax + request. It provides possibility to update s= everal child components + separately without updating the whole page.<= /para> = - @@ -1172,24 +1249,24 @@ ... ]]> - -
- - How to get row selection in scrollableDataTable usi= ng one and multi-selection - rows mode? - In order to get row selection in scrollableDataTable= using one and - multi-selection rows mode you s= hould use the - "selection" - attribute. - 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 - <rich:modalPanel> - with selected data will be shown. - - Example: - - +
+ + How to get row selection in scrollableDataTable= using one and + multi-selection rows mode? + In order to get row selection in scrollableDataT= able using one + and multi-selection rows mode you should use the + "selection" + attribute. + In the following example when user submits the f= orm current collection of + objects selected by user is placed in the ob= ject's property. Then on + complete action the + <rich:modalPanel><= /property> + with selected data will be shown= . + + Example: + + ...]]> - In order to build this application, you can create a= managed bean like this - one. Function takeSelection() fills t= he array selectedCars with the data, - got from the selection. Funct= ion getSelectedCars() - returns the array selectedCars, which= is - used for filling - <rich:dataTable> - with selected row/rows data. - - Example: - - In order to build this application, you can crea= te a managed bean like + this one. Function takeSelection() fills the array + selectedCars with the= data, got from the + selection. Fu= nction + getSelectedCars() ret= urns the array + selectedCars, which i= s used for filling + + <rich:dataTable> + with selected row/rows data. + + Example: + + selectedCars =3D new ArrayLis= t(); = @@ -1289,12 +1368,12 @@ } } ...]]> - Some additional information about usage of one and multi-selection - rows mode can be found here. -
- - = -
- - How to select several rows in a scrollableDataTable= and Drag-and-Drop them on dataTable? - - How to get row selection in scrollableDataTable using one and multi-selection rows mode = - you could see the section above. - - - In order to perform Drag-and-Drop of selected columns on a= dataTable you could use = - <rich:dragSupport>= and <rich:dropS= upport> - components as it is shown in the example below. - - - Example: - = - + + How to select several rows in a scrollableDataT= able and Drag-and-Drop + them on dataTable? + How to get row selection in scrollableDataTable= using one and + multi-selection rows mode you could see the + section above. + In order to perform Drag-and-Drop of selected c= olumns on a dataTable you + could use + <rich:dragSupport>= + and + <rich:dropSupport>= + components as it is shown in the= example below. + + Example: + + @@ -1538,9 +1619,12 @@ ...]]> - This is the page from RichFaces Live= Demo site and also uses beans from RichFaces LiveDemo site. = - Only one method is added where the dropped selectio= n is stored: - This is the page from RichFaces LiveDemo site a= nd also uses beans from + RichFaces LiveDemo site. Only one method is = added where the dropped + selection is stored: + = -
- = -
- - How to save the state of <rich:simpleTogglePanel= >? - - In order to save the state (exapnd/collapse) of the <rich:simpleTogglePanel> component = - you could use "opened" attribute responsible for keeping a panel state = - and <a4j:support><= /property> binded to "onexpand" and "oncollapse" events. - - - In the following example when you click on the tog= gle icon <rich:simpleTogglePanel> appears and current state displays on = - <rich:modalPa= nel>. - This state is remembered between page views. - - - Example: - - +
+ +
+ + How to save the state of <rich:simpleToggleP= anel>? + In order to save the state (exapnd/collapse) of= the + <rich:simpleTogglePan= el> + component you could use + "opened" + attribute responsible for keepin= g a panel state and + + <a4j:support> + binded to + "onexpand" + and + "oncollapse" + events. + In the following example when you click on the = toggle icon + <rich:simpleTogglePan= el> + appears and current state displa= ys on + <rich:modalPanel><= /property> + . This state is remembered betwee= n page views. + + Example: + + @@ -1595,14 +1688,13 @@ -...]]> = - - In order to build this application, you can create= a managed bean like this one. - - - Example: - - + In order to build this application, you can cre= ate a managed bean like + this one. + + Example: + + = -
- = -
- - How to save the state of <rich:panelMenuGroup>= ;? - - With the help of the "exp= anded" attribute = - and <a4j:supp= ort> binded to "onexpand&= quot; and "oncollapse"<= /property> events - you could keep the state ("expand"/"= ;collapse") of the <rich:panelMen= uGroup> component. - - - In the following example when you click on the tog= gle icon the <rich:panelMenuGroup><= /property> - expands and current state displays on <rich:modalPanel>. - This state is remembered between page views. - - - Example: - - +
+ +
+ + How to save the state of <rich:panelMenuGrou= p>? + With the help of the + "expanded" + attribute and + <a4j:support> + binded to + "onexpand" + and + "oncollapse" + events you could keep the state + ("expand"/"collapse") of= the + + <rich:panelMenuGroup&= gt; + component. + In the following example when you click on the = toggle icon the + <rich:panelMenuGroup&= gt; + expands and current state displa= ys on + <rich:modalPanel><= /property> + . This state is remembered betwee= n page views. + + Example: + + @@ -1664,24 +1766,25 @@ -...]]> = - - In order to build this application, you can create= a managed bean like this one. - -
- = - = -
- - How to highlight rows in a dataTable when the mouse= is over? - - In order to highlight rows in a dataTable when the= mouse is over you should use = - "onRowMouseOver" and "onRowMouseOut" attributes. = - - - Example: - - + In order to build this application, you can cre= ate a managed bean like + this o= ne. +
+ + +
+ + How to highlight rows in a dataTable when the m= ouse is over? + In order to highlight rows in a dataTable when = the mouse is over you + should use + "onRowMouseOver&quo= t; + and + "onRowMouseOut"= ; + attributes. + + Example: + + = ...]]> - = -
- = -
- - How to select one row of a dataTable by clicking on= it, even if clicked in an inputText of this row? - In order to select one row of a dataTable by clicki= ng on it you could use JavaScript function described below. - - Example: - - + +
+ + How to select one row of a dataTable by clickin= g on it, even if clicked + in an inputText of this row? + In order to select one row of a dataTable by cli= cking on it you could use + JavaScript function described below. + + Example: + + var oldRow; function changeColor(row) @@ -1791,11 +1896,17 @@ } = ...]]> - Then you could use a4j:support with "event&quo= t; and "onsubmit" attributes. - - Example: - - Then you could use + a4j:support + with + "event" + and + "onsubmit" + attributes. + + Example: + + @@ -1805,31 +1916,42 @@ ... = -...]]> = -
= -
- - How to reRender table cells with <a4j:support>= ;? - In order to reRender table cells with <a4j:support> - you should set exact ids valu= es for every updatable components = - and point this id to the "reRender" attribute. - = - - Note: - The value of "reRen= der" = - attribute of the <= property><a4j:support> tag defines which part(s= ) = - of our page is (are) to be updated. In thi= s case, the only part of the page to update is the = - <h:ou= tputText> tag because its id - value matches to the value of "reRender" = - attribute. = - As you see, it's not difficult to update m= ultiple elements on the page, only list their ids as t= he value of = - "reRender" = - attribute . - - - Example: - - +
+
+ + How to reRender table cells with <a4j:suppor= t>? + In order to reRender table cells with + <a4j:support> + you should set exact i= ds values for + every updatable components and point this id to + the + "reRender" + attribute. + + + Note: + The value of + "reRender= " + attribute of the + <a4j:suppor= t> + tag defines which part= (s) of our page is (are) + to be updated. In this case, the o= nly part of the page to + update is the + <h:outputTe= xt> + tag because its id value + matches to the value of + "reRender= " + attribute. As you see,= it's not difficult to + update multiple elements on the pa= ge, only list their + ids= as the value of + "reRender= " + attribute . + + + Example: + + @@ -1850,10 +1972,13 @@ -...]]> = - As it could be seen in the example above, the footer= with <h:outputText> reRenderes. -
- = - + = - -
- - How to dynamic columns? - In order to create dynamic columns you could use the= <rich:column> component - with the"rendered" attribute. You should just set the value of defined dy= namic cell to the = - "rendered" attribute field. - - Example: - - + +
+ + How to dynamic columns? + In order to create dynamic columns you could use= the + <rich:column> + component with the + "rendered" + attribute. You should just set t= he value of defined + dynamic cell to the + "rendered" + attribute field. + + Example: + + =

Table

@@ -2103,12 +2233,12 @@ ...]]> - In order to build this application, you can create a= managed bean like this - one. - - Example: - - In order to build this application, you can crea= te a managed bean like + this one. + + Example: + + = - = -
-
- - RichFaces with Trinidad? - Here is a stripped down version of web.xml that int= egrates RichFaces and Trinidad. - = - - Example: - - +
+
+ + RichFaces with Trinidad? + Here is a stripped down version of web.xml that = integrates RichFaces and + Trinidad. + + + Example: + + = = -]]> = -
-
- - Why does Java Script conflict? - Richfaces 3.1.3 uses 1.6.0 version of prototype.js s= cript 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). Ver= sions conflict is the cause of the problem. - RichFaces 3.1.3 is bundled with the same ones as Pro= totype 1.6.0, Scriptaculous 1.8.0 - - Example in web.xml:: - - +
+
+ + Why does Java Script conflict? + 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 proble= m. + RichFaces 3.1.3 is bundled with the same ones as= Prototype 1.6.0, + Scriptaculous 1.8.0 + + Example in web.xml::= + + org.richfaces.ExcludeScripts Prototype,Scriptaculous -...]]> = - RichFaces components use Prototype very hard. In par= ticular, 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 co= mponents. - = -
- = -
- - <rich:fileUpload> with Seam - - The <rich:fil= eUpload> component could work together with Seam f= ramework. - - - Initialization parameters should be defined for Se= am Filter in web.xml. = - They will be automatically set up for Ajax4Jsf Fil= er by Seam framework on start up. = - - - Example: - - + RichFaces components use Prototype very hard. In= particular, some patches + has been removed that are already included i= nto 1.6.0. Adding feature + with exclusion makes it possible to use Prot= otype with version less + than 1.6.0. This will break some of the comp= onents. + +
+ +
+ + <rich:fileUpload> with Seam + The + <rich:fileUpload><= /property> + component could work together wi= th Seam framework. + Initialization parameters should be defined for= Seam Filter in web.xml. + They will be automatically set up for Ajax4J= sf Filer by Seam framework + on start up. + + Example: + + Seam Filter org.jboss.seam.servlet.SeamFilter @@ -2341,53 +2475,141 @@ 200000 -...]]> = -
-
- - Optional object selection in <rich:suggestionbox= > - - The <rich:sug= gestionbox> 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: - - - - - Add "usin= gSuggestObjects" attribute with "true"= value to = - = <rich:suggestionbox> = - - - - - Use "onob= jectchanged" event attribute = - to store objects currently selecte= d = - - - - - All selected objects are stored un= der suggestion.SelectedItems array. - Each array element contains of text and object properties. - So, you could iterate this array, = get not null objects and then get the property you nee= d. = - - - = -
-
- - How to handle ViewExpiredException? - - As RichFaces 3.1 is targeted = at JSF 1.1, = - you won't get ViewExpiredExceptions generated when using it with JSF 1.2. - This exception appears after session timeout. - - - Fortunately there is an easy workaround. Add to yo= ur web.xml: - - +
+ = +
+ + How to configure <rich:fileUpload> for My= Faces framework + To make + <rich:fileUpload> + component work properly with MyFaces frame= work, the + extentions filter for that framework should = be defined in web.xml + file. + + Example: + + + + Ajax4jsf Filter + ajax4jsf + org.ajax4jsf.Filter + + createTempFiles + true + + + + + + extensionsFilter + org.apache.myfaces.webapp.filter.ExtensionsFilter<= /filter-class> + + + Set the size limit for uploaded files. Forma= t: 10 - 10 bytes 10k - 10 KB 10m - 10 MB 1g - 1 GB = + + uploadMaxFileSize + 100m + + + + Set the threshold size - files below this li= mit 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 = + + uploadThresholdSize + 100k + + + + + + ajax4jsf + Faces Servlet + REQUEST + FORWARD + INCLUDE + ERROR + + + + + extensionsFilter + Faces Servlet + + + + + org.apache.myfaces.webapp.StartupServletContextL= istener + + + + + Faces Servlet + javax.faces.webapp.FacesServlet + 1 + + + + + Faces Servlet + *.jsf + +...]]> + Note, that definition and mapping of the extent= ions filter goes after + definition and mapping of ajax filter. This = is a required condition to + make it work properly. Moreover, the extenti= on filter should be mapped + on the faces servlet but not to *.jsf (!) to= provide this sequence + work properly. +
+ = +
+ + Optional object selection in <rich:suggestio= nbox> + The + <rich:suggestionbox&g= t; + 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: + + + Add + "usingSug= gestObjects" + attribute wi= th + "true" value t= o + <rich:sugge= stionbox> + + + + + Use + "onobject= changed" + event attrib= ute to store objects + currently selected + + + All selected objects are st= ored under + suggestion.Selecte= dItems + array. Each array elemen= t contains of + text and object + properties. So, you coul= d iterate this array, get + not null objec= ts + and then get the propert= y you need. + + +
+
+ + How to handle ViewExpiredException? + As RichFaces 3.1 is target= ed at JSF 1.1, you + won't get ViewExpiredExceptions generated when + using it with JSF 1.2. This exception appear= s after session timeout. + Fortunately there is an easy workaround. Add to= your web.xml: + com.sun.faces.enableRestoreView11Compatibility true -...]]> = -
+...]]> +
--===============7781368606925743789==--