Рефакторинг долог, а производительность и удовлетворение пользователя могут пострадать.Отображение разумного количества записей на странице всегда было важной частью любого приложения и доставляло множество забот разработчикам. CakePHP облегчает участь разработчика, предоставляя ему быстрый и легкий путь разбиения данных по страницам.
PaginatorHelper является отличным решением, потому что его легко использовать. Кроме собственно разбиения на страницы, он включает в себя несколько возможностей сортировки. Также поддерживается ajax-сортировка и разбиение на страницы.
В контроллере мы установим параметры разбиения в переменной $paginate. Здесь следует упомянуть, что ключ сортировки (order) должен быть задан в виде массива.
<?php
class RecipesController extends AppController {
var $paginate = array(
'limit' => 5,
'order' => array(
'Post.title' => 'asc'
)
);
}
?>
Другие ключи, которые могут быть включены в массив $paginate, соответствуют параметрам метода Model->findAll() (conditions, fields, order, limit, page и recursive). Можно определить несколько наборов параметров в контроллере, достаточно просто разместить их после модели, которую необходимо настроить.
<?php
class RecipesController extends AppController {
var $paginate = array(
'Recipe' => array (...),
'Author' => array (...)
);
}
?>
После того, как переменная $paginate определена, можно вызвать метод paginate() в действиях контроллера. Он вернет результаты вызова findAll(), разбитые на страницы, а также передаст дополнительную статистику в отображение. Этот метод также добавляет PaginatorHelper в список хелперов контроллера, если это еще не было сделано.
function list_recipes() {
// аналогично findAll(), но результат разбит на страницы
$data = $this->paginate('Recipe');
$this->set(compact('data'));
}
Ваше дело решать, как показывать данные пользователю, но чаще всего они отображаются в HTML таблицах. Пример ниже предполагает размещение в таблице, но PaginatorHelper, доступный в отображениях не всегда должен быть так ограничен.
Как упоминалось, PaginatorHelper предоставляет возможности сортировки, которые могут быть интегрированы в заголовки таблицы:
app/views/recipes/list_recipes.ctp
<table>
<tr>
<th><?php echo $paginator->sort('ID', 'id');?></th>
<th><?php echo $paginator->sort('Title', 'title');?></th>
</tr>
<?php foreach($data as $recipe): ?>
<tr>
<td><?php echo $recipe['Recipe']['id']; ?></td>
<td><?php echo $recipe['Recipe']['title']; ?></td>
</tr>
<?php endforeach; ?>
</table>
Ссылки, которые создает метод PaginatorHelper->sort(), позволяют пользователю сортировать данные по определенному полю, щелкнув на заголовке столбца таблицы.
И последний ингредиент разбиения на страницы в отображениях –- навигация по страницам, также генерируемая PaginatorHelper.
<!-- Отображает ссылки на предыдущую и следующую страницы-->
<?php
echo $paginator->prev('<< Previous ', null, null, array('class' => 'disabled'));
echo $paginator->next(' Next >>', null, null, array('class' => 'disabled'));
?>
<!—выводит X из Y, где X – текущая страница, а Y – их общее количество. -->
<?php echo $paginator->counter() ?>
Вывод метода counter() может быть настроен с помощью специальных маркеров:
<?php
echo $paginator->counter(
array(
'format' => 'Страница %page% из %pages%, просматривается %current% записей
из %count% всего, начиная с %start%и заканчивая на %end%'
)
);
?>
В разбиение страниц легко добавить ajax-функциональность. Единственное, что потребуется –- это подключить js-библиотеку Prototype, установить индикатор (иконка загрузки внутри DIV’а) и указать DIV, который будет обновляться вместо перезагрузки страницы.
В заголовке подключаем Prototype, устанавливаем индикатор (spinner.gif), и определяем DIV с содержимым («content»).
Верстка может выглядеть вот так (код приведен частично):
<html>
<head>
<title><?php echo $title_for_layout; ?></title>
<?php echo $javascript->link(array('prototype')); ?>
<style type="text/css">
div.disabled {
display: inline;
float: none;
clear: none;
color: #C0C0C0;
}
</style>
</head>
<body>
<div id="main">
<div id="spinner" style="display: none; float: right;">
<?php echo $html->image('spinner.gif'); ?>
</div>
<div id="content">
<?php echo $content_for_layout; ?>
</div>
</div>
</body>
</html>
Единственная дополнительная настройка для разбиения на страницы с использованием ajax производится с помощью метода PaginationHelper::options(), который определяет необходимые параметры ajax. В данном случае, мы определяем, что все ссылки должны обновлять элемент, ID которого равен “content”, данными и во время загрузки будет отображаться “spinner”.
Обратите внимание: если ключ 'update' не задан, PaginationHelper будет выводить обычные (не-ajax) ссылки.
<?php
//Sets the update and indicator elements by DOM ID
$paginator->options(array('update' => 'content', 'indicator' => 'spinner'));
echo $paginator->prev('<< Previous', null, null, array('class' => 'disabled'));
echo $paginator->next('Next >>', null, null, array('class' => 'disabled'));
?>
<!-- prints X of Y, where X is current page and Y is number of pages -->
<?php echo $paginator->counter(); ?>
Надо заметить, что paginating подерживается начиная с 1.2.x. В stable еще нет.
Приношу извинения за клевету %), проглядел, ибо новичок в Cake PHP? и на этом ресурсе. Отличный ресурс, творческих успехов в этом году всем, кто его развивает!
Эм, а как изменить кол-во записей на странице?.. Кроме того, что выставить по умолчанию ?
'limit' => 5 в var $paginate, первый же пример. вместо 5 – нужное число.
Это да, но я не об этом. Как сделать что чтото вроде такого:
Record per page 5|10|20|30
Нажал на к примеру на 30, 30 записей и выводит...
а я об этом. сделай ссылки и в пиши в куку/сессию/бд/передавай именованным параметром это значение. а при паджинации указывай это число в лимите.
http://site.com/reports/index/page:2http://site.com/reports/index/news/all/page:2http://site.com/news/page:2 ?
http://site.com/news/page:2
http://site.com/index/mypage/page:2/id:16/sort:LOGIN/direction:asc, нашёл такой костыль так чтобы в контроллере указать можно было: $this->request->params['named']['id'] = $id;