cvs: peardoc /en/package/html/pager-sliding compare.xml

From: Date: Sun, 18 May 2003 19:13:43 +0000
Subject: cvs: peardoc /en/package/html/pager-sliding compare.xml
Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-828@lists.php.net to get a copy of this message
quipo Sun May 18 15:13:43 2003 EDT Modified files: /peardoc/en/package/html/pager-sliding compare.xml Log: fix the example Index: peardoc/en/package/html/pager-sliding/compare.xml diff -u peardoc/en/package/html/pager-sliding/compare.xml:1.1 peardoc/en/package/html/pager-sliding/compare.xml:1.2 --- peardoc/en/package/html/pager-sliding/compare.xml:1.1 Mon Apr 28 02:26:56 2003 +++ peardoc/en/package/html/pager-sliding/compare.xml Sun May 18 15:13:43 2003 @@ -1,4 +1,4 @@ -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <refentry id="package.html.pager-sliding.compare"> <refnamediv> <refname><classname>Pager</classname> vs. <classname>Pager_Sliding</classname></refname> @@ -7,7 +7,7 @@ <refsect1 id="package.html.pager-sliding.compare.intro"> <title>What are the differences with <classname>Pager</classname>?</title> <para> - While <classname>Pager</classname> has a "jumping window" style, + While <classname>Pager</classname> has a "jumping window" style, <classname>Pager_Sliding</classname> has a "sliding window" style. What does that mean? Let's see an example: </para> @@ -17,23 +17,23 @@ <para> Let's suppose that the data spans on 15 pages, and the window width is 5 page links. The links are built on "frames" of 5 pages each: [1-5] [6-10] [11-15] - <classname>Pager</classname> always shows the same 5 page links while you are on + <classname>Pager</classname> always shows the same 5 page links while you are on one of these pages. Here's a temporal succession of the links, starting from page 1 and moving forward. There are brakets around current page number to highlight this: <programlisting role="php"> <![CDATA[ -a) {1} 2 3 4 5 => // first frame: [1-5] -b) <= 1 {2} 3 4 5 => -c) <= 1 2 {3} 4 5 => -d) <= 1 2 3 {4} 5 => -e) <= 1 2 3 4 {5} => // HERE IT JUMPS TO THE NEXT FRAME -f) <= {6} 7 8 9 10 => // second frame: [6-10] -g) <= 6 {7} 8 9 10 => -h) <= 6 7 {8} 9 10 => +a) {1} 2 3 4 5 => // first frame: [1-5] +b) <= 1 {2} 3 4 5 => +c) <= 1 2 {3} 4 5 => +d) <= 1 2 3 {4} 5 => +e) <= 1 2 3 4 {5} => // HERE IT JUMPS TO THE NEXT FRAME +f) <= {6} 7 8 9 10 => // second frame: [6-10] +g) <= 6 {7} 8 9 10 => +h) <= 6 7 {8} 9 10 => ]]> </programlisting> - and so on. See what a "jumping window" frame is? When you reach a limit (in the + and so on. See what a "jumping window" frame is? When you reach a limit (in the example, you go from page 5 to page 6), it "jumps" to next frame (links from page 6 to 10). </para> </refsect1> @@ -42,18 +42,18 @@ <title><classname>Pager_Sliding</classname> logic</title> <para> Instead of jumping from one frame to the other, with <classname>Pager_Sliding</classname> - the change is done smoothly, and the current page is always shown at the center of the + the change is done smoothly, and the current page is always shown at the center of the "window" (except of course for the first and the last pages): <programlisting role="php"> <![CDATA[ -a) {1} 2 3 4 5 => [15] -b) [1] <= {2} 3 4 5 6 => [15] -c) [1] <= 2 {3} 4 5 6 => [15] -d) [1] <= 2 3 {4} 5 6 => [15] // HERE IT's STARTING WORKING AS DESIGNED -e) [1] <= 3 4 {5} 6 7 => [15] // see: current page number is at the center of the window -f) [1] <= 4 5 {6} 7 8 => [15] // and it stays there... -g) [1] <= 5 6 {7} 8 9 => [15] -h) [1] <= 6 7 {8} 9 10 => [15] +a) {1} 2 3 4 5 => [15] +b) [1] <= 1 {2} 3 4 5 => [15] +c) [1] <= 1 2 {3} 4 5 => [15] // HERE IT's STARTING WORKING AS DESIGNED +d) [1] <= 2 3 {4} 5 6 => [15] // see: current page number is at the center of the window +e) [1] <= 3 4 {5} 6 7 => [15] // and it stays there... +f) [1] <= 4 5 {6} 7 8 => [15] +g) [1] <= 5 6 {7} 8 9 => [15] +h) [1] <= 6 7 {8} 9 10 => [15] ]]> </programlisting> and so on. @@ -64,12 +64,12 @@ <refsect1 id="package.html.pager-sliding.compare.other"> <title>Other differences</title> <para> - Apart from the different "philosophy", <classname>Pager_Sliding</classname> - is also designed to be highly customizable. + Apart from the different "philosophy", <classname>Pager_Sliding</classname> + is also designed to be highly customizable. <itemizedlist> <listitem> <para> - There are *many* options to change the look and feel of the links in your page. + There are *many* options to change the look and feel of the links in your page. They are explained in the constructor docs. </para> </listitem> @@ -80,15 +80,15 @@ </listitem> <listitem> <para> - It is "template"-friendly, i.e. you can assign the processed links and - page numbers to your custom vars and use them to draw your link bar according + It is "template"-friendly, i.e. you can assign the processed links and + page numbers to your custom vars and use them to draw your link bar according to your page layout, without worrying about the underlying logic. </para> </listitem> <listitem> <para> You can easily extend the class; this is useful if you plan to use the class - in many different pages and you don't want to set the same options everytime: + in many different pages and you don't want to set the same options everytime: just set your preferred default values in your extending class and you're done! </para> </listitem>

« previous php.pear.doc (#828) next »