From richfaces-svn-commits at lists.jboss.org Fri Aug 15 07:38:02 2008
Content-Type: multipart/mixed; boundary="===============2922751431327975159=="
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: r10110 -
 trunk/docs/userguide/en/src/main/docbook/modules.
Date: Fri, 15 Aug 2008 07:38:01 -0400
Message-ID: <E1KTxd3-0000Nw-RF@committer01.frg.pub.inap.atl.jboss.com>

--===============2922751431327975159==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: artdaw
Date: 2008-08-15 07:38:01 -0400 (Fri, 15 Aug 2008)
New Revision: 10110

Modified:
   trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml
Log:
https://jira.jboss.org/jira/browse/RF-3594 - "process" attribute was edited=
 in the Guide

Modified: trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover=
.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/userguide/en/src/main/docbook/modules/RFCarchitectover.xml	2=
008-08-15 11:30:26 UTC (rev 10109)
+++ trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml	2=
008-08-15 11:38:01 UTC (rev 10110)
@@ -1291,27 +1291,37 @@
 		<section id=3D"process">
 			<title>Decide what to process</title>
 			<para>
-				In order to process defined components you could use the
-				<emphasis>
-					<property>&quot;process&quot;</property>
-				</emphasis>
-				attribute.
+				The <emphasis><property>&quot;process&quot;</property></emphasis> attr=
ibute allows to =

+				define the ids of components to be processed together with the compone=
nt which is marked as <property>ajaxSingle</property> or wrapped to region. =

 			</para>
 			<para>
-				The
-				<emphasis>
-					<property>&quot;process&quot;</property>
-				</emphasis>
-				attribute defines the ids of the components to be
-				processed together with the component which contains
-				this attribute. In order to define processed components
-				you could set theirs ids into the value of the
-				<emphasis>
-					<property>&quot;process&quot;</property>
-				</emphasis>
-				attribute.
+				You could make use of the <emphasis><property>&quot;process&quot;</pro=
perty></emphasis> attribute when you need to process only two
+				components in the different parts of view.
 			</para>
 			<para>
+				Imagine you need to process only two input fields but not all the view.
+				If you wrap the first input to region or make <emphasis role=3D"bold">=
<property>&lt;a4j:support&gt;</property></emphasis> component  =

+				with <code>ajaxSingle=3D&quot;true&quot;</code> nested the second inpu=
t will not be processed.
+			</para>
+			<para>
+				Here is a simple solution:
+			</para>
+			<programlisting role=3D"XML"><![CDATA[...
+<h:inputText value=3D"#{bean.name}" id=3D"name">
+	<a4j:support ajaxSingle=3D"true" process=3D"email" event=3D"onblur" reRen=
der=3D"someOut"/>
+</h:inputText>
+<h:inputTextarea value=3D"#{bean.description}" id=3D"desc" />
+<h:inputText value=3D"#{bean.email}" id=3D"email">
+	<a4j:support ajaxSingle=3D"true" process=3D"name" event=3D"onblur" reRend=
er=3D"someOut"/>
+</h:inputText>
+...]]></programlisting>
+			<para>
+				In the example above when the input field with the <code>id=3D&quot;na=
me&quot;</code> looses focus, an AJAX request is sent. =

+				So only two input fields (with <code>id=3D&quot;name&quot;</code> and =
additionally with <code>id=3D&quot;email&quot;</code>) =

+				are processed: decoding, conversion/validation, value applying phases =
are executed. =

+				The input field with the <code>id=3D&quot;email&quot;</code> is handle=
d the same way on blur event.
+			</para>
+			<!--para>
 				The
 				<emphasis>
 					<property>&quot;process&quot;</property>
@@ -1379,7 +1389,7 @@
 					<property>&lt;h:outputText&gt;</property>
 				</emphasis>
 				.
-			</para>
+			</para-->
 		</section>
 	</section>
 =



--===============2922751431327975159==--