Author: msorokin
Date: 2009-09-09 12:25:42 -0400 (Wed, 09 Sep 2009)
New Revision: 15510
Modified:
branches/community/3.3.X/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml
Log:
https://jira.jboss.org/jira/browse/RF-7388
partial rendering is documented
Modified:
branches/community/3.3.X/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml
===================================================================
---
branches/community/3.3.X/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml 2009-09-09
16:04:24 UTC (rev 15509)
+++
branches/community/3.3.X/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml 2009-09-09
16:25:42 UTC (rev 15510)
@@ -113,6 +113,37 @@
automatically. </para>
</formalpara>
</section>
+
+ <section>
+ <title>Partial Rendering</title>
+ <para>
+ RichFaces framework enhances the JSF framework with partial rendering of the
components with Ajax capability enabled.
+ This means that only the part of the page that should be affected by some change is
updated. Ajax capability of the components can be enabled by the
<emphasis><property>"mode"</property></emphasis>,
<emphasis><property>"switchType"</property></emphasis>
etc. set to "ajax".
+ This approach prevents multiple page refreshes, which minimized server load.
+ </para>
+ <para>
+ A good example that can illustrate this feature is rendering of the tabs of the
<emphasis
role="bold"><property><rich:tabPanel></property></emphasis>.
+ By default the component updates the whole page to display the content of the tab
which is clicked on, to enable partial rendering the
<emphasis><property>"switchType"</property></emphasis>
attribute set to "ajax" should be used.
+ </para>
+ <programlisting role="XML"><![CDATA[...
+<rich:tabPanel switchType="ajax">
+ <rich:tab label="Tab 1">
+ Content of Tab 1
+ </rich:tab>
+ <rich:tab label="Tab 2">
+ Content of Tab 2
+ </rich:tab>
+ <rich:tab label="Tab 3">
+ Content of Tab 3
+ </rich:tab>
+</rich:tabPanel>
+...]]></programlisting>
+
+ </section>
+
+
+
+
<section id="IntegralParts" role="new">
<?dbhtml filename="IntegralParts.html"?>
<title>RichFaces Integral Parts</title>