Author: artdaw
Date: 2008-01-04 11:25:25 -0500 (Fri, 04 Jan 2008)
New Revision: 5144
Modified:
trunk/docs/userguide/en/src/main/docbook/included/form.xml
Log:
http://jira.jboss.com/jira/browse/RF-1813 - done
Modified: trunk/docs/userguide/en/src/main/docbook/included/form.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/form.xml 2008-01-04 16:23:33 UTC
(rev 5143)
+++ trunk/docs/userguide/en/src/main/docbook/included/form.xml 2008-01-04 16:25:25 UTC
(rev 5144)
@@ -53,12 +53,17 @@
<section>
<title>Key attributes and ways of usage</title>
<para>The difference with the original component is that all hidden fields
required for command links are always rendered and it doesn't depend on links
rendering on the initial page. It solves the problem with invalid links that weren't
rendered on a page immediately, but after some Ajax request.</para>
- <para>Beginning with release 1.0.5 additional attributes that make this form
variant universal have appeared. With a new attribute definition as ajax=<emphasis
>
- <property>"true"</property>
- </emphasis>, it becomes possible to set Ajax submission way for any
components inside, i.e. not a page URL is used as an <emphasis >
- <property>"action"</property>
- </emphasis> attribute, but the javascript:A4J.AJAX.Submit(...) call. In this
case, rendering is defined as "reRender"=list of Ids for the form
element itself.</para>
- <para>Example</para>
+ <para>Beginning with release 1.0.5 additional attributes that make this form
variant universal have appeared.
+ </para>
+ <para>
+ If
<emphasis><property>"ajaxSubmit"</property></emphasis>
attribute is true,
+ it becomes possible to set Ajax submission way for any components inside,
+ i.e. not a page URL is used as an
<emphasis><property>"action"</property></emphasis>
attribute, but the javascript:A4J.AJAX.Submit(...) call.
+ In this case, the
<emphasis><property>"reRender"</property></emphasis>
attribute contains a list of Ids of components defined for re-rendering.
+ If you have <emphasis
role="bold"><property><h:commandButton></property></emphasis>
or
+ <emphasis
role="bold"><property><h:commandLink></property></emphasis>
inside the form, they work as <emphasis
role="bold"><property><a4j:commandButton></property></emphasis>.
+ </para>
+ <para><emphasis
role="bold">Example:</emphasis></para>
<programlisting role="XML"><![CDATA[<a4j:form
id="helloForm" ajaxSubmit="true" reRender="table">
...
<t:dataTable id="table"... >
@@ -81,7 +86,13 @@
<property><h:commandLink></property>
</emphasis> and can't be made Ajax ones with using e.g. <emphasis
role="bold">
<property><a4j:support></property>
- </emphasis>.</para>
+ </emphasis>.
+</para>
+ <para>
+ With the help of
<emphasis><property>"limitToList"</property></emphasis>
attribute you can limit areas, which are updated after the responses.
+ If
<emphasis><property>"limitToList"</property></emphasis>
is true, only the reRender attribute is taken in account.
+ Therefore, if you use blocks of text wrapped with <emphasis
role="bold"><property><a4j:outputPanel></property></emphasis>
and
<emphasis><property>"ajaxRendered"</property></emphasis>=
<property>true</property>, blocks of text are ignored.
+ </para>
</section>
<section>
<title>Relevant resources links</title>