Paginador
*********

.[perex]
Necessidade de uma listagem de dados? Como a matemática por trás da paginação pode ser complicada, [api:Nette\Utils\Paginator] o ajudará.


Instalação:

```shell
composer require nette/utils
```

Vamos criar um objeto de paginação e definir informações básicas para ele:

```php
$paginator = new Nette\Utils\Paginator;
$paginator->setPage(1); // o número da página atual (numerada a partir de 1)
$paginator->setItemsPerPage(30); // o número de registros por página
$paginator->setItemCount(356); // o número total de registros (se disponível)
```

As páginas são numeradas a partir de 1. Podemos mudá-las usando `setBase()`:

```php
$paginator->setBase(0); // numerada a partir de 0
```

O objeto fornecerá agora todas as informações básicas úteis para a criação de um paginador. Você pode, por exemplo, passá-lo para um modelo e usá-lo lá.

```php
$paginator->isFirst(); // esta é a primeira página?
$paginator->isLast(); // esta é a última página?
$paginator->getPage(); // número da página atual
$paginator->getFirstPage(); // o número da primeira página
$paginator->getLastPage(); // o número da última página
$paginator->getFirstItemOnPage(); // número seqüencial do primeiro item da página
$paginator->getLastItemOnPage(); // número seqüencial do último item da página
$paginator->getPageIndex(); // número de página atual se numerado a partir de 0
$paginator->getPageCount(); // o número total de páginas
$paginator->getItemsPerPage(); // o número de registros por página
$paginator->getItemCount(); // o número total de registros (se disponível)
```

O paginador ajudará na formulação da consulta SQL. Os métodos `getLength()` e `getOffset()` retornam os valores que você pode usar nas cláusulas LIMIT e OFFSET:

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

Se você precisar paginar em ordem inversa, ou seja, a página nº. 1 corresponde ao deslocamento mais alto, você pode usar `getCountdownOffset()`:

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

Um exemplo de uso na aplicação pode ser encontrado no livro de receitas [Paginação de Resultados do Banco de Dados |best-practices:pagination].