Paginator

Szüksége van az adatok listázásának lapozására? Mivel a lapozási matematika trükkös lehet, a Nette\Utils\Paginator segít ebben.

Telepítés:

composer require nette/utils 

Létrehozunk egy lapozó objektumot és beállítjuk az alapvető információkat:

$paginator = new Nette\Utils\Paginator; $paginator->setPage(1); // az aktuális oldal száma $paginator->setItemsPerPage(30); // elemek száma oldalanként $paginator->setItemCount(356); // az elemek teljes száma, ha ismert 

Az oldalak 1-től vannak számozva. Ezt megváltoztathatjuk a setBase() segítségével:

$paginator->setBase(0); // 0-tól számozunk 

Az objektum most minden alapvető információt megad, ami hasznos a lapozó létrehozásakor. Például átadhatja egy sablonnak és ott felhasználhatja.

$paginator->isFirst(); // az első oldalon vagyunk? $paginator->isLast(); // az utolsó oldalon vagyunk? $paginator->getPage(); // az aktuális oldal száma $paginator->getFirstPage(); // az első oldal száma $paginator->getLastPage(); // az utolsó oldal száma $paginator->getFirstItemOnPage(); // az oldalon lévő első elem sorszáma $paginator->getLastItemOnPage(); // az oldalon lévő utolsó elem sorszáma $paginator->getPageIndex(); // az aktuális oldal száma 0-tól számozva $paginator->getPageCount(); // az oldalak teljes száma $paginator->getItemsPerPage(); // elemek száma oldalanként $paginator->getItemCount(); // az elemek teljes száma, ha ismert 

A lapozó segít az SQL lekérdezés megfogalmazásában. A getLength() és getOffset() metódusok olyan értékeket adnak vissza, amelyeket a LIMIT és OFFSET klauzulákban használhatunk:

$result = $database->query(	'SELECT * FROM items LIMIT ? OFFSET ?',	$paginator->getLength(),	$paginator->getOffset(), ); 

Ha fordított sorrendben kell lapoznunk, azaz az 1. oldal a legmagasabb offsetnek felel meg, használjuk a getCountdownOffset() metódust:

$result = $database->query(	'SELECT * FROM items LIMIT ? OFFSET ?',	$paginator->getLength(),	$paginator->getCountdownOffset(), ); 

Alkalmazásbeli használati példát a Adatbázis eredmények lapozása szakácskönyvben talál.