JBoss Rich Faces SVN: r7710 - trunk/docs/userguide/en/src/main/docbook/included.
by richfaces-svn-commits＠lists.jboss.org
Author: artdaw
Date: 2008-04-09 12:21:19 -0400 (Wed, 09 Apr 2008)
New Revision: 7710
Modified:
trunk/docs/userguide/en/src/main/docbook/included/pickList.desc.xml
Log:
http://jira.jboss.com/jira/browse/RF-2174 - Key Features were added
Modified: trunk/docs/userguide/en/src/main/docbook/included/pickList.desc.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/pickList.desc.xml 2008-04-09 16:20:16 UTC (rev 7709)
+++ trunk/docs/userguide/en/src/main/docbook/included/pickList.desc.xml 2008-04-09 16:21:19 UTC (rev 7710)
@@ -26,17 +26,21 @@
<section>
<title>Key Features</title>
<itemizedlist>
- <listitem>Highly customizable look and feel</listitem>
- <!--listitem>Customizable component layout (captions, headers, list items and ordering control set)</listitem-->
- <!--listitem>Disabled/enabled ordering controls</listitem-->
- <listitem>Multiple selection of list items</listitem>
- <listitem>Keyboard support</listitem>
- <!--listitem>Possibility to manage selection from
- <itemizedlist>
- <listitem>Keyboard</listitem>
- <listitem>Server side</listitem>
- </itemizedlist>
- </listitem-->
+ <listitem>
+ <para>Multiple selection of list items</para>
+ </listitem>
+ <listitem>
+ <para>Keyboard support</para>
+ </listitem>
+ <listitem>
+ <para>Supports standard JSF internationalization</para>
+ </listitem>
+ <listitem>
+ <para>Highly customizable look and feel</para>
+ </listitem>
+ <listitem>
+ <para>Disablement support</para>
+ </listitem>
</itemizedlist>
</section>
</section>
16 years, 9 months
JBoss Rich Faces SVN: r7709 - trunk/docs/userguide/en/src/main/docbook/included.
by richfaces-svn-commits＠lists.jboss.org
Author: artdaw
Date: 2008-04-09 12:20:16 -0400 (Wed, 09 Apr 2008)
New Revision: 7709
Modified:
trunk/docs/userguide/en/src/main/docbook/included/fileUpload.xml
Log:
http://jira.jboss.com/jira/browse/RF-1207 - Details of Usage were edited according to doc file
Modified: trunk/docs/userguide/en/src/main/docbook/included/fileUpload.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/fileUpload.xml 2008-04-09 16:19:01 UTC (rev 7708)
+++ trunk/docs/userguide/en/src/main/docbook/included/fileUpload.xml 2008-04-09 16:20:16 UTC (rev 7709)
@@ -183,7 +183,7 @@
<listitem>
<para>
By <property>max files quantity</property>, use the <emphasis><property> "maxFilesQuantity"</property></emphasis> attribute
- to define max number of files allowed to be uploaded. After a number of files in the list equals to the value of this attribute "Add" button is disabled and nothing could be uploaded even if you clean the whole list.
+ to define max number of files allowed to be uploaded. After a number of files in the list equals to the value of this attribute "Add" button is disabled and nothing could be uploaded even if you clear the whole list.
In order to upload files again you should rerender the component.
As it could be seen in the example below, only 2 files are accepted for uploading.
</para>
@@ -374,6 +374,11 @@
<property>RICH_FILE_UPLOAD_ENTRY_CANCEL_LABEL</property> there.
</para>
+ <para>
+ The <emphasis role="bold"><property><rich:fileUpload></property></emphasis> component could work together with Seam framework.
+ <ulink url="http://www.jboss.org/file-access/default/members/jbossrichfaces/freezone/...">Here</ulink> you can see how to configure Seam Filter in order to handle
+ <emphasis role="bold"><property><rich:fileUpload></property></emphasis> requests.
+ </para>
</section>
16 years, 9 months
JBoss Rich Faces SVN: r7708 - trunk/docs/userguide/en/src/main/resources/images.
by richfaces-svn-commits＠lists.jboss.org
Author: msorokin
Date: 2008-04-09 12:19:01 -0400 (Wed, 09 Apr 2008)
New Revision: 7708
Added:
trunk/docs/userguide/en/src/main/resources/images/progressbarNoLabel.png
trunk/docs/userguide/en/src/main/resources/images/progressbarParams.png
Log:
http://jira.jboss.com/jira/browse/RF-1690
Fixing descriptions, basing on the comments of developers
Added: trunk/docs/userguide/en/src/main/resources/images/progressbarNoLabel.png
===================================================================
(Binary files differ)
Property changes on: trunk/docs/userguide/en/src/main/resources/images/progressbarNoLabel.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/docs/userguide/en/src/main/resources/images/progressbarParams.png
===================================================================
(Binary files differ)
Property changes on: trunk/docs/userguide/en/src/main/resources/images/progressbarParams.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
16 years, 9 months
JBoss Rich Faces SVN: r7707 - trunk/docs/userguide/en/src/main/docbook/included.
by richfaces-svn-commits＠lists.jboss.org
Author: artdaw
Date: 2008-04-09 12:18:33 -0400 (Wed, 09 Apr 2008)
New Revision: 7707
Modified:
trunk/docs/userguide/en/src/main/docbook/included/fileUpload.desc.xml
Log:
http://jira.jboss.com/jira/browse/RF-1207 - Key features were updated
Modified: trunk/docs/userguide/en/src/main/docbook/included/fileUpload.desc.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/fileUpload.desc.xml 2008-04-09 16:17:22 UTC (rev 7706)
+++ trunk/docs/userguide/en/src/main/docbook/included/fileUpload.desc.xml 2008-04-09 16:18:33 UTC (rev 7707)
@@ -2,6 +2,7 @@
<section>
<sectioninfo>
<keywordset>
+ <keyword>fileUpload</keyword>
<keyword>rich:fileUpload</keyword>
</keywordset>
</sectioninfo>
@@ -28,11 +29,12 @@
<itemizedlist>
<listitem><para>ProgressBar shows the status of downloads</para></listitem>
<listitem><para>Highly customizable look and feel</para></listitem>
- <listitem><para>File types and file sizes restrictions</para></listitem>
+ <listitem><para>File types, file sizes and files count restrictions</para></listitem>
<listitem><para>Multiple files upload support</para></listitem>
<listitem><para>Possibility to cancel the request</para></listitem>
<listitem><para>One request for every upload</para></listitem>
<listitem><para>Automatic uploads</para></listitem>
+ <listitem><para>Supports standard JSF internationalization</para></listitem>
<listitem><para>Disablement support</para></listitem>
</itemizedlist>
</section>
16 years, 9 months
JBoss Rich Faces SVN: r7706 - trunk/docs/userguide/en/src/main/docbook/included.
by richfaces-svn-commits＠lists.jboss.org
Author: msorokin
Date: 2008-04-09 12:17:22 -0400 (Wed, 09 Apr 2008)
New Revision: 7706
Modified:
trunk/docs/userguide/en/src/main/docbook/included/progressBar.desc.xml
trunk/docs/userguide/en/src/main/docbook/included/progressBar.xml
Log:
http://jira.jboss.com/jira/browse/RF-1690
Fixing descriptions, basing on the comments of developers
Modified: trunk/docs/userguide/en/src/main/docbook/included/progressBar.desc.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/progressBar.desc.xml 2008-04-09 16:11:39 UTC (rev 7705)
+++ trunk/docs/userguide/en/src/main/docbook/included/progressBar.desc.xml 2008-04-09 16:17:22 UTC (rev 7706)
@@ -23,10 +23,12 @@
<section>
<title>Key Features</title>
<itemizedlist>
- <listitem><para>Highly customizable look and feel</para></listitem>
- <listitem><para>Status polling frequency and timeout adjustment</para></listitem>
+
+ <listitem><para>Option to control rerendering frequency</para></listitem>
<listitem><para>Ajax or Client modes</para></listitem>
- <listitem><para>Option to display some numeric data along side with graphical presentation</para></listitem>
+ <listitem><para>Possibility to display status information on the progress bar </para></listitem>
+ <listitem><para>Highly customizable look and feel</para></listitem>
+
</itemizedlist>
</section>
</section>
\ No newline at end of file
Modified: trunk/docs/userguide/en/src/main/docbook/included/progressBar.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/progressBar.xml 2008-04-09 16:11:39 UTC (rev 7705)
+++ trunk/docs/userguide/en/src/main/docbook/included/progressBar.xml 2008-04-09 16:17:22 UTC (rev 7706)
@@ -67,29 +67,69 @@
As it was mentioned above, the <emphasis role="bold"><property><rich:progressBar></property></emphasis>
component displays the status of the ongoing process.
</para>
+
+ <para>The <emphasis role="bold"><property><rich:progressBar></property> </emphasis> component can run in two modes: Ajax (default) and Client.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para><property>Ajax</property> - In this mode the component works the same way as <emphasis role="bold"><property><a4j:poll/></property></emphasis> which gets the current progress value from the sever, repeating after a set time interval. </para>
+
+ </listitem>
+ <listitem>
+ <para><property>Client</property> - The current progress value in <property>Client</property> mode is set using JavaScript API </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ In order to define the mode you need to use <emphasis><property>"mode"</property></emphasis> attribute.
+ </para>
+
+
+
+
+ <para>
+ One of the key attributes of the component is <emphasis><property>"interval"</property></emphasis> which defines the frequency of status polling and rerenders the component when the value is updated.
+ </para>
<para>
+ Polling is active while the <emphasis><property>"enabled"</property></emphasis> attribute is "true".</para>
+ <para>
+ <emphasis role="bold">Example:</emphasis>
+ </para>
+ <programlisting role="XML"><![CDATA[...
+<rich:progressBar value="#{bean.incValue}" id="progrs" interval="900" enabled="true"/>
+...]]> </programlisting>
+
+ <para>
+ With the help of <emphasis><property>"timeout"</property></emphasis> attribute you can define the waiting time on a particular request.
+ If a response is not received during this time the request is aborted.
+ </para>
+
+
+ <para>
Status of the process is calculated basing on values of the following attributes:
<itemizedlist>
<listitem>
<para>
- <emphasis><property>"value"</property></emphasis> attribute sets the current value of the process
+ <emphasis><property>"value"</property></emphasis> is a value binding to the current progress value
</para>
</listitem>
<listitem>
<para>
- <emphasis><property>"minValue"</property></emphasis> (default value is "0") sets minimal value for
- the <emphasis role="bold"><property><rich:progressBar></property></emphasis> to start rendering
+ <emphasis><property>"minValue"</property></emphasis> (default value is "0") sets minimal progress value
</para>
</listitem>
<listitem>
<para>
- <emphasis><property>"maxValue"</property></emphasis> (default value is "100") sets maximum value for
- the <emphasis role="bold"><property><rich:progressBar></property></emphasis> to finish rendering
+ <emphasis><property>"maxValue"</property></emphasis> (default value is "100") sets maximum progress value
</para>
</listitem>
</itemizedlist>
</para>
+
+
+
+
+
<para>
<emphasis role="bold">Example:</emphasis>
</para>
@@ -97,6 +137,34 @@
<programlisting role="XML"><![CDATA[...
<rich:progressBar value="#{bean.incValue}" minValue="50" maxValue="400"/>
...]]> </programlisting>
+<para>This is the result</para>
+ <figure>
+ <title>Progress bar</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/progressbarNoLabel.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
<!--para>
The <emphasis><property> "label"</property></emphasis> attribute is responsible for displaying informational
@@ -143,13 +211,13 @@
</listitem>
<listitem>
- <para>Using <emphasis role="bold"><property><h:outputText /></property></emphasis></para>
+ <para>Using any child components that display text. One of the components that can be used is <emphasis role="bold"><property><h:outputText /></property></emphasis></para>
<para>
<emphasis role="bold">Example:</emphasis>
</para>
<programlisting role="XML"><![CDATA[...
-<rich:progressBar value="#{bean.incValue1}">
- <h:outputText value="#{bean.incValue1}"/>
+<rich:progressBar value="#{bean.incValue}">
+ <h:outputText value="#{bean.incValue} %"/>
</rich:progressBar>
...]]> </programlisting>
</listitem>
@@ -250,12 +318,16 @@
(e.g parameters="param:'#{bean.incValue1}'")
and you can use it to pass the data.
</para-->
+
+
+
+
<para>
The <emphasis><property>"parameters"</property></emphasis>
is also a special attribute that defines parameters for substitution in the label.
- All you need is to define a value of your own parameter
+ All you need is to define the value of your own parameter
(e.g parameters="param:'#{bean.incValue1}'")
and you can use it to pass the data.
</para>
@@ -265,33 +337,27 @@
</para>
<programlisting role="XML"><![CDATA[...
-<progressBar:progressBar value="#{bean.incValue1}" parameters="param:'#{bean.incValue1}'">
- <h:outputText value="{param}%"/>
-</progressBar:progressBar>
+<rich:progressBar value="#{bean.incValue}" parameters="param:'#{bean.dwnlSpeed}'">
+ <h:outputText value="download speed {param} KB/s"/>
+</rich:progressBar>
...]]> </programlisting>
-
+ <para>This is the result</para>
+ <figure>
+ <title>Usage of parameters</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/progressbarParams.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-
+
+
<!-- END Parameters-->
- <para>
- The <emphasis><property>"interval"</property></emphasis> attribute defines the frequency of status polling.
- </para>
- <para>
- Polling is active while the <emphasis><property>"enabled"</property></emphasis> attribute is "true".</para>
- <para>
- <emphasis role="bold">Example:</emphasis>
- </para>
- <programlisting role="XML"><![CDATA[...
-<rich:progressBar value="#{bean.incValue}" id="progrs" interval="900" enabled="true"/>
-...]]> </programlisting>
+
- <para>
- With the help of <emphasis><property>"timeout"</property></emphasis> attribute you can define the waiting time on a particular request.
- If a response is not received during this time the request is aborted.
- </para>
-
<para>
The component can also employ <emphasis><property> "initial"</property></emphasis> and <emphasis><property> "complete"</property></emphasis>
@@ -313,16 +379,7 @@
...]]> </programlisting>
<para> However, the usage of these facets is optional. If you omit them nothing will be displayed.
</para>
- <para>The <emphasis role="bold"><property><rich:progressBar></property> </emphasis> component can be used in two modes: Ajax (default) and Client. In order to define the mode you need to use <emphasis><property>"mode"</property></emphasis> attribute.
- </para>
- <itemizedlist>
- <listitem>
- <para><property>Ajax</property> - polling is activated when the component is enabled to check its value. </para>
- </listitem>
- <listitem>
- <para><property>Client</property> - component updates after its value changed through JavaScript API. </para>
- </listitem>
- </itemizedlist>
+
</section>
<!-- End. Details of Usage-->
16 years, 9 months
JBoss Rich Faces SVN: r7705 - trunk/ui/scrollableDataTable/src/main/templates/org/richfaces.
by richfaces-svn-commits＠lists.jboss.org
Author: konstantin.mishin
Date: 2008-04-09 12:11:39 -0400 (Wed, 09 Apr 2008)
New Revision: 7705
Modified:
trunk/ui/scrollableDataTable/src/main/templates/org/richfaces/scrollable-data-table.jspx
Log:
RF-2766
Modified: trunk/ui/scrollableDataTable/src/main/templates/org/richfaces/scrollable-data-table.jspx
===================================================================
--- trunk/ui/scrollableDataTable/src/main/templates/org/richfaces/scrollable-data-table.jspx 2008-04-09 13:43:52 UTC (rev 7704)
+++ trunk/ui/scrollableDataTable/src/main/templates/org/richfaces/scrollable-data-table.jspx 2008-04-09 16:11:39 UTC (rev 7705)
@@ -238,34 +238,31 @@
</jsp:scriptlet>
<f:call name="contributorsEncodeHere"/>
- <script id="#{clientId}_grid_create_scripts" type="text/javascript">
- //<![CDATA[
-
- #{this:getJavaScriptVarName(context, component)} = #{this:createClientScrollableGrid(context, component)};
- #{this:getScriptContributions(context, component)};
-
- // ]]>
- </script>
- <f:call name="tearDownState"/>
</div>
</td>
</tr>
- <jsp:scriptlet>
- <![CDATA[
- facet = component.getFacet("footer");
- if (null != facet && facet .isRendered()) {
- ]]>
- </jsp:scriptlet>
<tr>
+ <jsp:scriptlet>
+ <![CDATA[
+ facet = component.getFacet("footer");
+ if (null == facet || !facet.isRendered()) {
+ getUtils().writeAttribute(writer, "style", "display:none;" );
+ }
+ ]]>
+ </jsp:scriptlet>
<td>
<u:insertFacet name="footer" />
+ <script id="#{clientId}_grid_create_scripts" type="text/javascript">
+ //<![CDATA[
+
+ #{this:getJavaScriptVarName(context, component)} = #{this:createClientScrollableGrid(context, component)};
+ #{this:getScriptContributions(context, component)};
+
+ // ]]>
+ </script>
+ <f:call name="tearDownState"/>
</td>
</tr>
- <jsp:scriptlet>
- <![CDATA[
- }
- ]]>
- </jsp:scriptlet>
</tbody>
</table>
</f:root>
16 years, 9 months
JBoss Rich Faces SVN: r7704 - trunk/docs/userguide/en/src/main/docbook/included.
by richfaces-svn-commits＠lists.jboss.org
Author: artdaw
Date: 2008-04-09 09:43:52 -0400 (Wed, 09 Apr 2008)
New Revision: 7704
Modified:
trunk/docs/userguide/en/src/main/docbook/included/modalPanel.xml
Log:
fix title for tag <important>
Modified: trunk/docs/userguide/en/src/main/docbook/included/modalPanel.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/modalPanel.xml 2008-04-09 13:21:21 UTC (rev 7703)
+++ trunk/docs/userguide/en/src/main/docbook/included/modalPanel.xml 2008-04-09 13:43:52 UTC (rev 7704)
@@ -130,7 +130,7 @@
</table>
<important>
- <title>New:</title>
+ <title>Important:</title>
<para>In order to avoid a bug in IE, the root node of the dialog is moved on the top of a DOM
tree. However, you should have a separate form inside the modal panel if you want to perform
submits from this panel. </para>
16 years, 9 months
JBoss Rich Faces SVN: r7703 - trunk/ui/combobox/src/main/resources/org/richfaces/renderkit/html/scripts.
by richfaces-svn-commits＠lists.jboss.org
Author: vmolotkov
Date: 2008-04-09 09:21:21 -0400 (Wed, 09 Apr 2008)
New Revision: 7703
Modified:
trunk/ui/combobox/src/main/resources/org/richfaces/renderkit/html/scripts/combolist.js
Log:
http://jira.jboss.com/jira/browse/RF-2894
Modified: trunk/ui/combobox/src/main/resources/org/richfaces/renderkit/html/scripts/combolist.js
===================================================================
--- trunk/ui/combobox/src/main/resources/org/richfaces/renderkit/html/scripts/combolist.js 2008-04-09 13:14:28 UTC (rev 7702)
+++ trunk/ui/combobox/src/main/resources/org/richfaces/renderkit/html/scripts/combolist.js 2008-04-09 13:21:21 UTC (rev 7703)
@@ -296,6 +296,7 @@
var curItems = this.getItems();
if (curItems != null && curItems.length != 0) {
this.doActiveItem(curItems[curItems.length - 1]);
+ this.scrollingUpToItem(curItems[curItems.length - 1]);
}
}
return;
@@ -310,6 +311,7 @@
var curItems = this.getItems();
if (curItems != null && curItems.length != 0) {
this.doActiveItem(curItems[0]);
+ this.scrollingUpToItem(curItems[0]);
}
}
return;
16 years, 9 months
JBoss Rich Faces SVN: r7702 - trunk/ui/combobox/src/main/resources/org/richfaces/renderkit/html/scripts.
by richfaces-svn-commits＠lists.jboss.org
Author: vmolotkov
Date: 2008-04-09 09:14:28 -0400 (Wed, 09 Apr 2008)
New Revision: 7702
Modified:
trunk/ui/combobox/src/main/resources/org/richfaces/renderkit/html/scripts/combolist.js
Log:
http://jira.jboss.com/jira/browse/RF-2894
Modified: trunk/ui/combobox/src/main/resources/org/richfaces/renderkit/html/scripts/combolist.js
===================================================================
--- trunk/ui/combobox/src/main/resources/org/richfaces/renderkit/html/scripts/combolist.js 2008-04-09 13:09:43 UTC (rev 7701)
+++ trunk/ui/combobox/src/main/resources/org/richfaces/renderkit/html/scripts/combolist.js 2008-04-09 13:14:28 UTC (rev 7702)
@@ -291,8 +291,13 @@
moveActiveItem : function(event) {
var item = this.activeItem;
if (event.keyCode == Event.KEY_UP) {
- //part of http://jira.jboss.com/jira/browse/RF-2656 (pressing key DOWN) will be implemented in a future version
if (!this.activeItem) {
+ if (!this.selectFirstOnUpdate) {
+ var curItems = this.getItems();
+ if (curItems != null && curItems.length != 0) {
+ this.doActiveItem(curItems[curItems.length - 1]);
+ }
+ }
return;
}
var prevItem = item.previousSibling;
16 years, 9 months
JBoss Rich Faces SVN: r7701 - in trunk/docs/userguide/en/src/main: resources/images and 1 other directory.
by richfaces-svn-commits＠lists.jboss.org
Author: cluts
Date: 2008-04-09 09:09:43 -0400 (Wed, 09 Apr 2008)
New Revision: 7701
Modified:
trunk/docs/userguide/en/src/main/docbook/included/column.desc.xml
trunk/docs/userguide/en/src/main/docbook/included/column.xml
trunk/docs/userguide/en/src/main/resources/images/columnFilt1.png
trunk/docs/userguide/en/src/main/resources/images/columnsort1.png
Log:
RF-1740 - updated information for sorting and filtering; updated screens
Modified: trunk/docs/userguide/en/src/main/docbook/included/column.desc.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/column.desc.xml 2008-04-09 13:06:51 UTC (rev 7700)
+++ trunk/docs/userguide/en/src/main/docbook/included/column.desc.xml 2008-04-09 13:09:43 UTC (rev 7701)
@@ -23,7 +23,8 @@
<listitem>Completely skinned table rows and child elements</listitem>
<listitem>Possibility to combine columns with the help of <emphasis ><property>"colspan"</property></emphasis></listitem>
<listitem>Possibility to combine rows with the help of <emphasis ><property>"rowspan"</property></emphasis> and <emphasis ><property>"breakBefore"</property></emphasis></listitem>
- <listitem>Possibility to sort and to filter of columns</listitem>
+ <listitem>Sorting column values</listitem>
+ <listitem>Filtering column values</listitem>
</itemizedlist>
</section>
</section>
\ No newline at end of file
Modified: trunk/docs/userguide/en/src/main/docbook/included/column.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/column.xml 2008-04-09 13:06:51 UTC (rev 7700)
+++ trunk/docs/userguide/en/src/main/docbook/included/column.xml 2008-04-09 13:09:43 UTC (rev 7701)
@@ -189,8 +189,8 @@
<section>
<title>Sorting</title>
<para>
- In order to sort the columns you could use <emphasis><property>"sortBy"</property></emphasis> attribute
- which defines a bean property which is used for sorting of a column. See the following example.
+ In order to sort the columns you could use <emphasis><property>"sortBy"</property></emphasis> attribute indicates what values to be sorted column.
+ The original column is not sorted. In order to sort the column should double-click on its header. See the following example.
</para>
<para>
<emphasis role="bold">Example:</emphasis>
@@ -227,10 +227,34 @@
</imageobject>
</mediaobject>
</figure>
-
<para>
- In order to change sort order you could use <emphasis><property>"sortOrder"</property></emphasis> attribute.
+ The <emphasis><property>"selfSorted"</property></emphasis> attribute
+ that would add the possibility of automatic sorting by clicking the column header.
+ Default value is "true". In the example below the second column is unavailable for sorting.
</para>
+ <para>
+ <emphasis role="bold">Example:</emphasis>
+ </para>
+ <programlisting role="XML"><![CDATA[...
+<rich:dataTable value="#{capitalsBean.capitals}" var="cap">
+ <rich:column>
+ <f:facet name="header">
+ <h:outputText value="State Flag"/>
+ </f:facet>
+ <h:graphicImage value="#{cap.stateFlag}"/>
+ </rich:column>
+ <rich:column sortBy="#{cap.state}" selfSorted="false">
+ <f:facet name="header">
+ <h:outputText value="State Name"/>
+ </f:facet>
+ <h:outputText value="#{cap.state}"/>
+ </rich:column>
+</rich:dataTable>
+...]]></programlisting>
+ <para>
+ <emphasis><property>"sortOrder"</property></emphasis> attribute
+ is used for changing the sorting of columns by means of external controls.
+ </para>
<para>Possible values are:</para>
<itemizedlist>
<listitem>
@@ -244,12 +268,6 @@
</listitem>
</itemizedlist>
<para>
- If you don't use <emphasis><property>"sortOrder"</property></emphasis> attribute then the first column is sorted in ascending.
- </para>
- <para>
- In order to change the sort order, you could double-click on the header of column, which you want to sort.
- </para>
- <para>
<emphasis role="bold">Example:</emphasis>
</para>
<programlisting role="XML"><![CDATA[...
@@ -289,14 +307,14 @@
<para>
The <emphasis><property>"sortPriority"</property></emphasis> attribute
defines a set of column <property>ids</property> in the order the columns could be set.
- </para>
+ </para>
<para>
If the columns sort order changed externally sort priorities could be used to define which columns will be sorted first.
</para>
<!--para>
Note that <emphasis><property>"sortPriority"</property></emphasis> attribute is defined in
the <emphasis role="bold"><property><rich:dataTable></property></emphasis> component!
- </para-->
+ </para-->
<para>
<emphasis role="bold">Example:</emphasis>
</para>
@@ -322,38 +340,6 @@
</h:form>
...]]></programlisting>
<para>
- You could manage if the header of the column is clickable, icons rendered and sorting is fired after click on the header
- with the help of the following attributes:
- </para>
- <itemizedlist>
- <listitem>
- <para>
- The <emphasis><property>"selfSorted"</property></emphasis> attribute
- which is defined in <emphasis role="bold"><property><rich:dataTable></property></emphasis> component.
- Default value is "true". In the example below the second column is unavailable for sorting.
- </para>
- <para>
- <emphasis role="bold">Example:</emphasis>
- </para>
- <programlisting role="XML"><![CDATA[...
-<rich:dataTable value="#{capitalsBean.capitals}" var="cap">
- <rich:column>
- <f:facet name="header">
- <h:outputText value="State Flag"/>
- </f:facet>
- <h:graphicImage value="#{cap.stateFlag}"/>
- </rich:column>
- <rich:column sortBy="#{cap.state}" selfSorted="false">
- <f:facet name="header">
- <h:outputText value="State Name"/>
- </f:facet>
- <h:outputText value="#{cap.state}"/>
- </rich:column>
-</rich:dataTable>
-...]]></programlisting>
- </listitem>
- <listitem>
- <para>
The <emphasis><property>"sortable"</property></emphasis> attribute which is used
with <emphasis role="bold"><property><rich:scrollableDataTable></property></emphasis> component.
In the following example only the first column could be sorted.
@@ -394,18 +380,6 @@
</imageobject>
</mediaobject>
</figure>
- </listitem>
- </itemizedlist>
-
- <note>
- <title>Note:</title>
- <para>
- The <emphasis><property>"sortExpression"</property></emphasis> attribute that defines
- sorting property is deprecated! You could use the <emphasis><property>"sortBy"</property></emphasis> attribute
- for the same purpose.
- </para>
- </note>
-
<para>
Sorting could not be used together with pagination.
Only row that currently on the client could be sorted.
@@ -471,7 +445,7 @@
</listitem>
<listitem>
<para>
- Using external filtering. In this case you need to write your custom filtering function and define controls.
+ Using external filtering. In this case you need to write your custom filtering function or expression and define controls.
</para>
<para>
The <emphasis><property>"filterExpression"</property></emphasis> attribute is used to define expression evaluated to boolean value.
Modified: trunk/docs/userguide/en/src/main/resources/images/columnFilt1.png
===================================================================
(Binary files differ)
Modified: trunk/docs/userguide/en/src/main/resources/images/columnsort1.png
===================================================================
(Binary files differ)
16 years, 9 months