Постраничное разделение данных ¶

В случае когда требуется отобразить слишком много данных на одной странице, эта страница зачастую разделяется на несколько частей, каждая из которых содержит и отображает только часть данных за один раз. Такие части называются страницами, а сам процесс называется постраничным разделением данных.

Если вы используете провайдер данных с одним из виджетов данных, то в этом случае будет автоматически использовано постраничное разделение данных. В противном случае вам требуется создать объект yii\data\Pagination, заполнить его такими данными как общее количество элементов, yii\data\Pagination::$pageSize и yii\data\Pagination::$page, затем применить его к запросу и передать в элемент нумерации страниц.

Первым делом в действии контроллера мы создаем объект постраничного разделения данных и заполняем его данными:

function actionIndex()
{
    $query = Article::find()->where(['status' => 1]);
    $countQuery = clone $query;
    $pages = new Pagination(['totalCount' => $countQuery->count()]);
    $models = $query->offset($pages->offset)
        ->limit($pages->limit)
        ->all();

    return $this->render('index', [
         'models' => $models,
         'pages' => $pages,
    ]);
}

Затем в представлении мы выводим модели для текущей страницы и передаем объект постраничного разделение данных в элемент нумерации страниц:

foreach ($models as $model) {
    // отображаем здесь $model
}

// отображаем ссылки на страницы
echo LinkPager::widget([
    'pagination' => $pages,
]);