Class: Pager_Jumping

Source Location: /Pager-2.2.5/Jumping.php

Class Overview

Pager_Common
   |
   --Pager_Jumping

Pager_Jumping - Jumping Window Pager

Author(s):

Lorenzo Alberton <at quipo.it l.alberton at quipo.it>
Richard Heyes <richard at phpguru.org>,

Version:

$Id: Jumping.php,v 1.5 2004/01/16 10:29:57 quipo Exp $

Inherited Variables

Class: Pager_Common

Pager_Common::$links
Pager_Common::$linkTags
Pager_Common::$range

Inherited Methods

Class: Pager_Common

Pager_Common::errorMessage(): Return a textual error message for a PAGER error code
Pager_Common::getCurrentPageID(): Returns ID of current page
Pager_Common::getLinks(): Returns back/next/first/last and page links, both as ordered and associative array.
Pager_Common::getNextPageID(): Returns next page ID. If current page is last page this function returns FALSE
Pager_Common::getOffsetByPageId(): Returns offsets for given pageID. Eg, if you pass it pageID one and your perPage limit is 10 it will return (1, 10). PageID of 2 would give you (11, 20).
Pager_Common::getPageData(): Returns an array of current pages data
Pager_Common::getPageIdByOffset(): Returns pageID for given offset
Pager_Common::getPageRangeByPageId()
Pager_Common::getPerPageSelectBox(): Returns a string with a XHTML SELECT menu,
Pager_Common::getPreviousPageID(): Returns previous page ID. If current page is first page this function returns FALSE
Pager_Common::isFirstPage(): Returns whether current page is first page
Pager_Common::isLastPage(): Returns whether current page is last page
Pager_Common::isLastPageComplete(): Returns whether last page is complete
Pager_Common::numItems(): Returns number of items
Pager_Common::numPages(): Returns number of pages

Class Details

[line 56]
Pager_Jumping - Jumping Window Pager

Handles paging a set of data. For usage see the example.php provided.

Author: Lorenzo Alberton <at quipo.it l.alberton at quipo.it>
Author: Richard Heyes <richard@phpguru.org>,
Version: $Id: Jumping.php,v 1.5 2004/01/16 10:29:57 quipo Exp $

[ Top ]

Method Detail

Pager_Jumping (Constructor) [line 68]

Pager_Jumping Pager_Jumping(
[mixed
$options = array()])

Constructor

Access: public

Parameters:

mixed $options — An associative array of option names and their values

[ Top ]

getLinks [line 163]

array getLinks(
[integer
$pageID = null], [string
$next_html = ''])

Returns back/next/first/last and page links, both as ordered and associative array.

NB: in original PEAR::Pager this method accepted two parameters, $back_html and $next_html. Now the only parameter accepted is an integer ($pageID), since the html text for prev/next links can be set in the constructor. If a second parameter is provided, then the method act as it previously did. This hack's only purpose is to mantain backward compatibility.

Return: Back/pages/next links

Overrides Pager_Common::getLinks() (Returns back/next/first/last and page links, both as ordered and associative array.)

Parameters:

integer	`$pageID`	—	Optional pageID. If specified, links for that page are provided instead of current one. [ADDED IN NEW PAGER VERSION]
string	`$next_html`	—	HTML to put inside the next link [deprecated: use the constructor instead]

[ Top ]

getPageIdByOffset [line 96]

int getPageIdByOffset(
$index
$index)

Returns pageID for given offset

Return: PageID for given offset

Overrides Pager_Common::getPageIdByOffset() (Returns pageID for given offset)

Parameters:

$index $index — Offset to get pageID for

[ Top ]

getPageRangeByPageId [line 126]

array getPageRangeByPageId(
[integer
$pageid = null])

Given a PageId, it returns the limits of the range of pages displayed.

While getOffsetByPageId() returns the offset of the data within the current page, this method returns the offsets of the page numbers interval. E.g., if you have pageId=3 and delta=10, it will return (1, 10). PageID of 8 would give you (1, 10) as well, because 1 <= 8 <= 10. PageID of 11 would give you (11, 20). If the method is called without parameter, pageID is set to currentPage#.

Return: First and last offsets
Access: public

Overrides Pager_Common::getPageRangeByPageId() (parent method not documented)

Parameters:

integer $pageid — PageID to get offsets for

[ Top ]