Author: vsukhov Date: 2008-04-10 14:11:42 -0400 (Thu, 10 Apr 2008) New Revision: 7744 Modified: trunk/docs/userguide/en/src/main/docbook/included/support.xml Log: http://jira.jboss.com/jira/browse/RF-2994 I've described process attribute for <a4j:support> Modified: trunk/docs/userguide/en/src/main/docbook/included/support.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/support.xml 2008-04-10 17:54:32 UTC (rev 7743) +++ trunk/docs/userguide/en/src/main/docbook/included/support.xml 2008-04-10 18:11:42 UTC (rev 7744) @@ -104,6 +104,41 @@ {form.reset(); return false;}" oncomplete="alert('Value succesfully stored')"/> </h:selectOneMenu>]]></programlisting> <para>In example there is the condition checking (confirm) is used before request sending and message printing after the request processing is over. </para> + <para> + <emphasis > + <property>&quot;process&quot;</property></emphasis> attribute defines the component 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 <emphasis > + <property>&quot;process&quot;</property></emphasis> attribute. </para> + <para> + <emphasis > + <property>&quot;process&quot;</property></emphasis> attribute attribute has two limitations: + <itemizedlist> + <listitem> + <para>it works only if <emphasis > + <property>&quot;ajaxSingle&quot;</property></emphasis> equals to "true" for given command component</para> + </listitem> + <listitem> + <para>you do not have to point this attribute to one of the own parent components to avoid processing of command component twice.</para> + </listitem> + </itemizedlist> + </para> + <para><emphasis role="bold">Example:</emphasis></para> + <programlisting role="XML"><![CDATA[... +<h:form> + <h:inputText id="oneA" value="#{bean.width}"/> + <br/> + <h:inputText id="oneB" value="#{bean.text}"/> + <br/> + <a4j:commandButton value="Submit2" process="oneB" ajaxSingle="true" reRender=":three1, :three2"/> +</h:form> + <h:outputText id="three1" value="#{bean.width}"/> + <br/> + <h:outputText id="three2" value="#{bean.text}"/> +...]]></programlisting> + <para> + In the example above only <emphasis role="bold"><property>&lt;h:inputText&gt;</property></emphasis> with "oneB" id process. + After you click on the button- the value of this component appears into the <emphasis role="bold"><property>&lt;h:outputText&gt;</property></emphasis> with "three2" id. + </para> <para>The components allows different Ajax request managing ways for its various optimization in particular conditions such as: <itemizedlist> <listitem>