From richfaces-svn-commits at lists.jboss.org Mon May 24 02:41:57 2010
Content-Type: multipart/mixed; boundary="===============8555458849660821169=="
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: r17198 - in
 root/docs/trunk/Component_Reference/en-US: extras and 1 other directory.
Date: Mon, 24 May 2010 02:41:57 -0400
Message-ID: <201005240641.o4O6fvXM012891@svn01.web.mwc.hst.phx2.redhat.com>

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

Author: SeanRogers
Date: 2010-05-24 02:41:57 -0400 (Mon, 24 May 2010)
New Revision: 17198

Added:
   root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Referenc=
e-Tables_and_grids-a4jrepeat_example.xml_sample
Modified:
   root/docs/trunk/Component_Reference/en-US/Component_Reference.xml
   root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Actio=
ns.xml
   root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Table=
s_and_grids.xml
Log:
a4j:repeat

Modified: root/docs/trunk/Component_Reference/en-US/Component_Reference.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
--- root/docs/trunk/Component_Reference/en-US/Component_Reference.xml	2010-=
05-23 19:51:06 UTC (rev 17197)
+++ root/docs/trunk/Component_Reference/en-US/Component_Reference.xml	2010-=
05-24 06:41:57 UTC (rev 17198)
@@ -21,7 +21,9 @@
 		<!-- =

 		<xi:include href=3D"chap-Component_Reference-Rich_inputs.xml" xmlns:xi=
=3D"http://www.w3.org/2001/XInclude" />
 		<xi:include href=3D"chap-Component_Reference-Panels_and_containers.xml" =
xmlns:xi=3D"http://www.w3.org/2001/XInclude" />
+		-->
 		<xi:include href=3D"chap-Component_Reference-Tables_and_grids.xml" xmlns=
:xi=3D"http://www.w3.org/2001/XInclude" />
+		<!--
 		<xi:include href=3D"chap-Component_Reference-Trees.xml" xmlns:xi=3D"http=
://www.w3.org/2001/XInclude" />
 		<xi:include href=3D"chap-Component_Reference-Menus_and_toolbars.xml" xml=
ns:xi=3D"http://www.w3.org/2001/XInclude" />
 		 --><xi:include href=3D"chap-Component_Reference-Output_and_messages.xml=
" xmlns:xi=3D"http://www.w3.org/2001/XInclude" />

Modified: root/docs/trunk/Component_Reference/en-US/chap-Component_Referenc=
e-Actions.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
--- root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Acti=
ons.xml	2010-05-23 19:51:06 UTC (rev 17197)
+++ root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Acti=
ons.xml	2010-05-24 06:41:57 UTC (rev 17198)
@@ -477,6 +477,48 @@
 		</para>
 	</section>
 	=

+	<section id=3D"sect-Component_Reference-Tables_and_grids-a4jrepeat">
+		<title><sgmltag>&lt;a4j:repeat&gt;</sgmltag></title>
+		<itemizedlist>
+			<listitem>
+				<para>
+					component-type: <classname>org.ajax4jsf.Repeat</classname>
+				</para>
+			</listitem>
+			<listitem>
+				<para>
+					component-family: <classname>javax.faces.Data</classname>
+				</para>
+			</listitem>
+			<listitem>
+				<para>
+					component-class: <classname>org.ajax4jsf.component.html.HtmlAjaxRepea=
t</classname>
+				</para>
+			</listitem>
+			<listitem>
+				<para>
+					renderer-type: <classname>org.ajax4jsf.components.RepeatRenderer</cla=
ssname>
+				</para>
+			</listitem>
+		</itemizedlist>
+		<para>
+			The <sgmltag>&lt;a4j:repeat&gt;</sgmltag> component is used to iterate =
changes through a repeated collection of components. It allows specific row=
s of items to be updated without sending Ajax requests for the entire colle=
ction. The <sgmltag>&lt;a4j:repeat&gt;</sgmltag> component forms the basis =
for many of the tabular components detailed in <xref linkend=3D"chap-Compon=
ent_Reference-Tables_and_grids" />.
+		</para>
+		<para>
+			The contents of the collection are determined using Expression Language=
 (<acronym>EL</acronym>). The data model for the contents is specified with=
 the <varname>value</varname> attribute. The <varname>var</varname> attribu=
te names the object to use when iterating through the collection. This obje=
ct is then referenced in the relevant child components. After an Ajax reque=
st, only the rows specified with the <varname>ajaxKeys</varname> attribute =
are updated rather than the entire collection. <xref linkend=3D"exam-Compon=
ent_Reference-Tables_and_grids-a4jrepeat_example" /> shows how to use <sgml=
tag>&lt;a4j:repeat&gt;</sgmltag> to maintain a simple table.
+		</para>
+		<example id=3D"exam-Component_Reference-Tables_and_grids-a4jrepeat_examp=
le">
+			<title><sgmltag>&lt;a4j:repeat&gt;</sgmltag> example</title>
+			<programlisting language=3D"XML" role=3D"XML"><xi:include parse=3D"text=
" href=3D"extras/exam-Component_Reference-Tables_and_grids-a4jrepeat_exampl=
e.xml_sample" xmlns:xi=3D"http://www.w3.org/2001/XInclude" /></programlisti=
ng>
+			<para>
+				Each row of a table contains two cells: one showing the item code, and=
 the other showing the item price. The table is generated by iterating thro=
ugh items in the <code>repeatBeans.items</code> data model.
+			</para>
+		</example>
+		<para>
+			The <sgmltag>&lt;a4j:repeat&gt;</sgmltag> component uses other attribut=
es common to iteration components, such as the <varname>first</varname> att=
ribute for specifying the first item for iteration, and the <varname>rows</=
varname> attribute for specifying the number of rows of items to display.
+		</para>
+	</section>
+	=

 	<section id=3D"sect-Component_Reference-Actions-a4jsupport">
 		<title><sgmltag>&lt;a4j:support&gt;</sgmltag></title>
 		<itemizedlist>

Modified: root/docs/trunk/Component_Reference/en-US/chap-Component_Referenc=
e-Tables_and_grids.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
--- root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Tabl=
es_and_grids.xml	2010-05-23 19:51:06 UTC (rev 17197)
+++ root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Tabl=
es_and_grids.xml	2010-05-24 06:41:57 UTC (rev 17198)
@@ -686,13 +686,6 @@
 		</para>
 	</section>
 	=

-	<section id=3D"sect-Component_Reference-Tables_and_grids-richrepeat">
-		<title><sgmltag>&lt;rich:repeat&gt;</sgmltag></title>
-		<para>
-			Incomplete
-		</para>
-	</section>
-	=

 	<section id=3D"sect-Component_Reference-Tables_and_grids-richsubTable">
 		<title><sgmltag>&lt;rich:subTable&gt;</sgmltag></title>
 		<para>

Added: root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Refe=
rence-Tables_and_grids-a4jrepeat_example.xml_sample
=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
--- root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Referen=
ce-Tables_and_grids-a4jrepeat_example.xml_sample	                        (r=
ev 0)
+++ root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Referen=
ce-Tables_and_grids-a4jrepeat_example.xml_sample	2010-05-24 06:41:57 UTC (r=
ev 17198)
@@ -0,0 +1,10 @@
+<table>
+    <tbody>
+        <a4j:repeat value=3D"#{repeatBean.items}" var=3D"item" ajaxKeys=3D=
"#{updateBean.updatedRow}">
+            <tr>
+                <td><h:outputText value=3D"#{item.code}" id=3D"item1" /></=
td>
+                <td><h:outputText value=3D"#{item.price}" id=3D"item2" /><=
/td>
+            </tr>
+        </a4j:repeat>
+    </tbody>
+</table>


--===============8555458849660821169==--