[richfaces-svn-commits] JBoss Rich Faces SVN: r2289 - trunk/docs/userguide/en/src/main/docbook/included.

richfaces-svn-commits at lists.jboss.org richfaces-svn-commits at lists.jboss.org
Thu Aug 16 08:30:13 EDT 2007


Author: vkorluzhenko
Date: 2007-08-16 08:30:13 -0400 (Thu, 16 Aug 2007)
New Revision: 2289

Modified:
   trunk/docs/userguide/en/src/main/docbook/included/datascroller.xml
Log:
http://jira.jboss.com/jira/browse/RF-603 - added info about using "controlSeparator" facet; corrected description.

Modified: trunk/docs/userguide/en/src/main/docbook/included/datascroller.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/datascroller.xml	2007-08-16 12:04:31 UTC (rev 2288)
+++ trunk/docs/userguide/en/src/main/docbook/included/datascroller.xml	2007-08-16 12:30:13 UTC (rev 2289)
@@ -74,15 +74,15 @@
   <section>
     <title>Details of Usage</title>
     <para>The <emphasis role="bold">
-        <property>&lt;rich:Datascroller&gt;</property>
-      </emphasis> component provides table scrolling functionality the same as tomahawk scroller but
+      <property>&lt;rich:Datascroller&gt;</property>
+    </emphasis> component provides table scrolling functionalitity the same as tomahawk scroller but
       with Ajax requests usage.</para>
     <para>The component should be placed into footer of the parent table or be bound to it with the <emphasis>
-        <property>&quot;for&quot;</property>
-      </emphasis> attribute.</para>
+      <property>&quot;for&quot;</property>
+    </emphasis> attribute.</para>
     <para>The table should also have the defined <emphasis>
-        <property>&quot;rows&quot;</property>
-      </emphasis> attribute limiting the quantity of inputted table rows.</para>
+      <property>&quot;rows&quot;</property>
+    </emphasis> attribute limiting the quantity of inputted table rows.</para>
     <para>The scroller could limit the maximum quantity of rendered links on the table pages with
       the help of the <emphasis>
         <property>&quot;maxPages&quot;</property>
@@ -91,8 +91,8 @@
     <itemizedlist>
       <listitem>Page numbers for switching onto a particular page</listitem>
       <listitem>The controls of fast switching: <emphasis>
-          <property>&quot;first&quot;,</property>
-        </emphasis>
+        <property>&quot;first&quot;,</property>
+      </emphasis>
         <emphasis>
           <property>&quot;last&quot;,</property>
         </emphasis>
@@ -111,7 +111,7 @@
     </itemizedlist>
     <para>The controls of fast switching are created adding the facets component with the
       corresponding name:</para>
-
+    
     <para>
       <emphasis role="bold">Example:</emphasis>
     </para>
@@ -126,9 +126,18 @@
     </rich:Datascroller>
 ...
 ]]></programlisting>
+    <figure>
+      <title>Datascroller controls</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/datascroller2.gif"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <para>The screenshot shows one controller from each group.</para>
     <para> There are also facets used to create the disabled states: <emphasis>
-        <property>&quot;first_disabled&quot;,</property>
-      </emphasis>
+      <property>&quot;first_disabled&quot;,</property>
+    </emphasis>
       <emphasis>
         <property>&quot;last_disabled&quot;,</property>
       </emphasis>
@@ -144,32 +153,21 @@
       <emphasis>
         <property>&quot;fastrewind_disabled&quot;</property>
       </emphasis>. </para>
-    <figure>
-      <title>Datascroller controls</title>
-      <mediaobject>
-        <imageobject>
-          <imagedata fileref="images/datascroller2.gif"/>
-        </imageobject>
-      </mediaobject>
-    </figure>
-    <para>The screenshot shows one controller from each group.</para>
     <para>For the <emphasis>
-        <property>&quot;fastforward&quot;</property>
-      </emphasis>/<emphasis>
-        <property>&quot;rewind&quot;</property>
-      </emphasis> controls customization the additional <emphasis>
-        <property>&quot;fastStep&quot;</property>
-      </emphasis> attribute is used. The attribute indicates pages quantity to switch onto when fast
+      <property>&quot;fastforward&quot;/&quot;fastrewind&quot;</property>
+    </emphasis> controls customization the additional <emphasis>
+      <property>&quot;fastStep&quot;</property>
+    </emphasis> attribute is used. The attribute indicates pages quantity to switch onto when fast
       scrolling is used. </para>
     <para>The <emphasis>
-        <property>&quot;pageIndexVar&quot;</property>
-      </emphasis> and <emphasis>
-        <property>&quot;pagesVar&quot;</property>
-      </emphasis> attributes provide an ability to show the current page and the number of pages in
-      the dataScroller. These attributes are used for definition the names of variables, that wiil
+      <property>&quot;pageIndexVar&quot;</property>
+    </emphasis> and <emphasis>
+      <property>&quot;pagesVar&quot;</property>
+    </emphasis> attributes provide an ability to show the current page and the number of pages in
+      the dataScroller. These attributes are used for definition the names of variables, that will
       be used in the facet with name<emphasis>
-        <property>&quot;pages&quot;</property>
-      </emphasis>.An example can be found below: </para>
+        <property>&quot;pages&quot;.</property>
+      </emphasis> An example can be found below: </para>
     <para>
       <emphasis role="bold">Example:</emphasis>
     </para>
@@ -190,8 +188,16 @@
       </h:form>
 ...
 ]]></programlisting>
-
-
+    <para> It&apos;s possible to insert optional separators between controls. For this purpose use a <emphasis>
+      <property>&quot;controlSeparator&quot;</property>
+    </emphasis> facet. An example is placed below. </para>
+    <programlisting role="XML"><![CDATA[ ...
+      <f:facet name="controlSeparator">
+            <h:graphicImage value="/image/sep.gif"/>
+      </f:facet>
+...
+]]></programlisting>
+    
   </section>
   <section>
     <title>Look-and-Feel Customization</title>




More information about the richfaces-svn-commits mailing list