Yii Framework, постраничная навигация CPaginatio
Yii Framework, постраничная навигация CPaginatio
ли у Вас большое количество страниц (товаров, элементов, …), которые выводятся в списке, то постраничный навигатор для более удобной навигации по сайту Вам просто необходим. На первый взгляд это достаточно сложная задача. Но так как постраничная навигация используется довольно часто, разработчики Yii Framework позаботились о том, что бы максимально упростить ее.
В первой части статьи речь пойдет о Yii CPagination, который позволяет нам очень просто разбить список записей на страницы (блоки) для постраничного навигатора сайта.
И так перейдем к примеру работы с Yii CPagination и описанию его свойств.
Пример постраничного навигатора.
В контроллере:
<?php
class PostController extends Controller {
//Ваш код...
function actionIndex() {
$criteria = new CDbCriteria();
$criteria->condition = 'visibility="1"';
$criteria->order = 'date DESC, id DESC';
$count = Post::model()->count($criteria);
$pagination = new CPagination($count);
$pagination->pageSize = 20; // Количество элементов на страницу
//$pagination->pageVar = 'p'; // Имя GET переменной хранения текущего индекса страницы. По умолчанию 'page'. Пример: /post/page/3
$pagination->applyLimit($criteria);
//$pagination->route = '/post/index'; //маршрут для отображения постраничной навигации. По умолчанию текущая страница.
$model = Post::model()->findAll($criteria);
$this->render('index', array(
'model' => $model,
'pagination' => $pagination
));
}
//Ваш код...
}
?>
Шаблон view:
<?php
//Ваш код...
//Вывод постраничного навигатора
$this->widget('CLinkPager', array(
'pages' => $pagination,
));
//Ваш код...
?>
Свойства и настройка CPagination:
| Свойство | Тип | По умолчанию | Описание |
|---|---|---|---|
| pageVar | string | page | Имя переменной GET храненящей текущий номер страницы. |
| itemCount | integer | 0 | Общее количество элементов. |
| pageSize | integer | 10 | Количество элементов на странице. |
| route | string | Маршрут (id контроллера и id действия) для отображения страниц. По умолчанию пустая строка, то есть с использованием текущего маршрута. | |
| limit | integer | Предел данных. Устанавливает limit значение SQL выборки данных для текущей страницы. Возвращает то же значение что и [[https:xn--d1acnqm.xn--j1amh/записи/yii_framework_постраничная_навигация_cpagination_часть_1#pageSize|pageSize]] . |
|
| offset | integer | Cмещение данных. Устанавливает offset значение SQL выборки данных для текущей страницы. |
|
| pageCount | integer | Количество страниц. | |
| currentPage | integer | 0 | Базовый индекс постраничного навигатора текущей страницы. |
| params | array | null | Массив параметров (имя => значение), которые должны использоваться вместо GET при генерации URL. По умолчанию null, что означает, использовать доступные в настоящее время параметры GET. |