[ajax4jsf-svn-commits] JBoss Ajax4JSF SVN: r275 - trunk/docs/userguide/en/src/main/docbook/modules.

Author: smukhina Date: 2007-06-22 09:43:38 -0400 (Fri, 22 Jun 2007) New Revision: 275 Modified: trunk/docs/userguide/en/src/main/docbook/modules/a4jUGusingAJAX.xml Log: Modified: trunk/docs/userguide/en/src/main/docbook/modules/a4jUGusingAJAX.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/modules/a4jUGusingAJAX.xml 2007-06-22 07:53:56 UTC (rev 274) +++ trunk/docs/userguide/en/src/main/docbook/modules/a4jUGusingAJAX.xml 2007-06-22 13:43:38 UTC (rev 275) @@ -57,9 +57,9 @@ </formalpara> <para>In the first case the whole JSF tree will be encoded, in the second one option it depends on the &quot;size&quot; of the AJAX region (you can define AJAX region - by using the <emphasis role="bold"><property>&lt;a4j:region&gt;</property></emphasis>). As you can see, in the second case the filter parses + by using the <emphasis role="bold"><property>&lt;a4j:region&gt;</property></emphasis>). As you can see, in the second case the filter parses the content of an AJAX response before sending it to the client side.</para> - <para>Have a look at the next picture to understand these two ways:</para> + <para>Have a look at the next picture to understand these two ways:</para> <figure> <title>Request Processing sequence diagram</title> </figure> @@ -71,8 +71,8 @@ <para>In both cases, the information about required static or dynamic resources that your application requests is registered in the ResourseBuilder class.</para> <para>When a request for a resource comes (Figure 4), the AJAX filter checks the Resource Cache - for this resource and if it is there, the resource will be sent to the client. Otherwise, - the filter will search for the resource among those that are registered by the + for this resource and if it is there, the resource is sent to the client. Otherwise, + the filter searches for the resource among those that are registered by the ResourceBuilder. If the resource is registered, the AJAX filter will send a request to the ResourceBuilder to create (deliver) the resource.</para> <para>Next Figure shows the ways of resource request processing.</para> @@ -109,7 +109,7 @@ <section id="LimitationsAndRules"> <?dbhtml filename="LimitationAndRules.html"?> <title>Limitations and Rules</title> - <para>In order to create AJAX JSF applications properly, keep the following points in mind:</para> + <para>In order to create AJAX4JSF applications properly, keep the following points in mind:</para> <itemizedlist> <listitem> The AJAX framework should not append or delete, but only replace elements on the page. For successful updates, an element with the same ID as in the response must exist on the page. If you&apos;d like to append any code to a page, put in a placeholder for it (any empty element). For the same reason, it&apos;s recommended to place messages in the<emphasis role="italic"> @@ -122,7 +122,7 @@ </emphasis> for self-rendered containers, since this component is transient and not saved in the tree. </listitem> <listitem> - AJAX requests are made by XMLHttpRequest functions in XML format, but this XML bypasses most validations and the corrections that might be made in a browser. So, create only strict standards-compliant code for HTML and XHTML, without skipping any required elements or attributes. Any necessary XML corrections are automatically made by the XML filter on the server, but lot&apos;s of unexpected effects can be produced by an incorrect HTML code. + AJAX requests are made by XMLHttpRequest functions in XML format, but this XML bypasses most validations and the corrections that might be made in a browser. So, create only a strict standards-compliant code for HTML and XHTML, without skipping any required elements or attributes. Any necessary XML corrections are automatically made by the XML filter on the server, but lot&apos;s of unexpected effects can be produced by an incorrect HTML code. </listitem> </itemizedlist> </section> @@ -155,8 +155,8 @@ <para> <emphasis role="bold"> <property>&lt;a4j:poll&gt;</property> - </emphasis> tag are used to send an AJAX - request periodically using timer. + </emphasis> tag is used to send an AJAX + request periodically using a timer. </para> <para>The <emphasis role="bold"> <property>&lt;a4j:support&gt;</property> @@ -176,7 +176,7 @@ <listitem> <emphasis role="italic"> <property>&quot;RequestDelay&quot;</property> - </emphasis> attribute is used for a requests frequency regulation. + </emphasis> attribute is used for a requests frequency regulation. </listitem> </itemizedlist> <programlisting role="XML"><![CDATA[<h:inputText size="50" value="#{bean.text}"> @@ -194,8 +194,8 @@ <listitem> <emphasis role="italic"> <property>&quot;LimitToList&quot;</property> - </emphasis> attribute is used to regulate updatable regions. Setting - it to true limits the updatable areas only to specified in + </emphasis> attribute is used for regulate updatable regions. Setting + it to true limits the updatable areas only to ones specified in a reRender list, in other case all Output Panels of the region are updated. </listitem> <listitem> <emphasis role="italic">