[ajax4jsf-svn-commits] JBoss Ajax4JSF SVN: r275 - trunk/docs/userguide/en/src/main/docbook/modules.
ajax4jsf-svn-commits at lists.jboss.org
ajax4jsf-svn-commits at lists.jboss.org
Fri Jun 22 09:43:38 EDT 2007
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 "size" of the AJAX region (you can define AJAX region
- by using the <emphasis role="bold"><property><a4j:region></property></emphasis>). As you can see, in the second case the filter parses
+ by using the <emphasis role="bold"><property><a4j:region></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'd like to append any code to a page, put in a placeholder for it (any empty element). For the same reason, it'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'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's of unexpected effects can be produced by an incorrect HTML code.
</listitem>
</itemizedlist>
</section>
@@ -155,8 +155,8 @@
<para>
<emphasis role="bold">
<property><a4j:poll></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><a4j:support></property>
@@ -176,7 +176,7 @@
<listitem>
<emphasis role="italic">
<property>"RequestDelay"</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>"LimitToList"</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">
More information about the ajax4jsf-svn-commits
mailing list