[richfaces-svn-commits] JBoss Rich Faces SVN: r5452 - trunk/docs/userguide/en/src/main/docbook/included.
richfaces-svn-commits at lists.jboss.org
richfaces-svn-commits at lists.jboss.org
Thu Jan 17 10:44:49 EST 2008
Author: artdaw
Date: 2008-01-17 10:44:49 -0500 (Thu, 17 Jan 2008)
New Revision: 5452
Modified:
trunk/docs/userguide/en/src/main/docbook/included/columns.xml
Log:
http://jira.jboss.com/jira/browse/RF-1199 - add description of the 'begin', 'end', 'rows', 'columns' attributes
Modified: trunk/docs/userguide/en/src/main/docbook/included/columns.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/columns.xml 2008-01-17 15:09:32 UTC (rev 5451)
+++ trunk/docs/userguide/en/src/main/docbook/included/columns.xml 2008-01-17 15:44:49 UTC (rev 5452)
@@ -70,10 +70,9 @@
<property><rich:columns></property>
</emphasis> component gets a list from data model and outputs corresponding set of columns inside
<emphasis role="bold"><property><rich:dataTable></property></emphasis> on a page.
+ It is possible to use <emphasis><property>"header"</property></emphasis> and <emphasis><property>"footer" </property></emphasis> facets
+ with <emphasis role="bold"><property><rich:columns></property></emphasis> component.
</para>
- <para>The <emphasis role="bold"><property><rich:columns></property></emphasis> component allows to use
- <emphasis><property>"header"</property></emphasis> and <emphasis><property>"footer" </property></emphasis> facets.
- </para>
<para>The simple example is placed below</para>
<para>
<emphasis role="bold">Example:</emphasis>
@@ -91,7 +90,47 @@
</rich:columns>
</rich:dataTable>
...]]></programlisting>
+ <para>
+ The <emphasis><property>"columns"</property></emphasis> attribute defines the count of columns.
+ </para>
+ <para>
+ The <emphasis><property>"rows"</property></emphasis> attribute defines the number of rows to be displayed. If the value of this attribute is zero,
+ all remaining rows in the table are displayed on a page.
+ </para>
+ <para>
+ The <emphasis><property>"begin"</property></emphasis> attribute contains the first iteration item. Note, that iteration begins from zero.
+ </para>
+ <para>
+ The <emphasis><property>"end"</property></emphasis> attribute contains the last iteration item.
+ </para>
+ <para>
+ With the help of the attributes described below you can customize the output, i.e. define which columns and how many rows appear on a page.
+ </para>
+ <para>
+ <emphasis role="bold">Example:</emphasis>
+ </para>
+ <programlisting role="XML"><![CDATA[...
+<rich:dataTable value="#{rowBean.rows}" var="row">
+ <rich:columns value="#{colBean.columns}" var="col" rows="0" columns="5" begin="1" end="5">
+ <f:facet name="header">
+ <h:outputText value="#{col.header}"/>
+ </f:facet>
+ <h:outputText value="#{row.columnValue}"/>
+ </rich:columns>
+</rich:dataTable>
+...]]></programlisting>
+ <para>
+ In the example below, columns from second to fourth and all rows are shown in the
+ <emphasis role="bold"><property><rich:dataTable></property></emphasis>.
+ </para>
+ <!--para>In order to group columns with text information into one row in one column with a flag, use
+ the <emphasis ><property>"colspan"</property></emphasis> attribute, which is similar to an HTML one, specifying that the first column contains 3 columns.
+ In addition, it's necessary to specify that the next column begins from the first row with the help of the
+ <emphasis ><property>"breakBefore"</property></emphasis> attribute = true.
+ </para-->
+
+
<para>
The <emphasis role="bold"><property><rich:columns></property></emphasis> component does not prevent to use
<emphasis role="bold"><property><rich:column></property></emphasis>.
More information about the richfaces-svn-commits
mailing list