Paginator
*********

.[perex]
¿Necesita paginar listados de datos? Como las matemáticas de la paginación pueden ser peliagudas, [api:Nette\Utils\Paginator] está aquí para ayudarle.


Instalación:

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

Creemos un objeto paginador y fijemos algunos datos básicos:

```php
$paginator = new Nette\Utils\Paginator;
$paginator->setPage(1); // número de la página actual
$paginator->setItemsPerPage(30); // número de elementos por página
$paginator->setItemCount(356); // número total de elementos (si se conoce)
```

Las páginas se numeran a partir de 1. Puede cambiarlo con `setBase()`:

```php
$paginator->setBase(0); // numeración desde 0
```

El objeto ofrece ahora toda la información esencial para crear los controles de paginación. Puede pasarlo, por ejemplo, a una plantilla y usarlo allí.

```php
$paginator->isFirst(); // ¿estamos en la primera página?
$paginator->isLast(); // ¿estamos en la última página?
$paginator->getPage(); // número de la página actual
$paginator->getFirstPage(); // número de la primera página
$paginator->getLastPage(); // número de la última página
$paginator->getFirstItemOnPage(); // número de orden del primer elemento de la página
$paginator->getLastItemOnPage(); // número de orden del último elemento de la página
$paginator->getBase(); // base de numeración de las páginas (1 de forma predeterminada)
$paginator->getPageCount(); // número total de páginas
$paginator->getItemsPerPage(); // número de elementos por página
$paginator->getItemCount(); // número total de elementos (si se conoce)
```

El paginador ayuda a formular las consultas SQL. Los métodos `getLength()` y `getOffset()` devuelven los valores que se usan en las cláusulas `LIMIT` y `OFFSET`:

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

Si necesita paginar en orden inverso (es decir, que la página 1 corresponda al desplazamiento más alto), use `getCountdownOffset()`:

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

Encontrará un ejemplo de uso en una aplicación en la receta [Paginar los resultados de la base de datos|best-practices:pagination].