Постраничная навигация

Для формирования и вывода в разделах постраничной навигации нужно использовать функцию:

browse_messages( $cc_env, $range, $user_template = false )

Массив $cc_env является неизменным параметром данной функции и содержит переменные окружения текущего компонента раздела.

Параметр $range определяет количество выводимых страниц. Вместо этой переменной обычно пишется число. Подразумевается, что из множества страниц одновременно будет показываться только список из $range страниц. Например, ваш листинг состоит из 20 страниц. Если $range=10, то, находясь на первой странице, вы будете видеть страницы с 1 по 10, находясь на 15-й странице, вы будете видеть страницы 10-20.

Массив $user_template[], для настройки формата отображения используется альтернативный пользовательский шаблон , значения которого указываются в системных настройках компонента или макете(в этом случае нужно сделать этот массив доступным в компоненте, с помощью global $user_template;), по умолчанию, если не передавать этот параметр, используется массив $browse_msg, который должен быть прописан в макете.

Макропеременная %PAGE обозначает номер страницы, макропеременная %URL – ссылку на соответствующие страницы. Возможно также использование макропеременных %FROM и %TO, соответственно обозначающих номера начального и конечного объекта на странице.

Пример составления формата отображения:

$browse_msg = array();
$browse_msg['prefix'] = "<nav>";
$browse_msg['prev'] = "<a href='%URL' >Назад</a>";  // если есть ссылка Назад
$browse_msg['prev_none'] = "<a class='disabled' href='#'>Назад</a>";  // если нет ссылки Назад
$browse_msg['active'] = "<a href='%URL'>%PAGE</a>";
$browse_msg['unactive'] = "<a href='%URL'>%PAGE</a>";
$browse_msg['divider'] = "";
$browse_msg['next'] = "<a href='%URL'>Вперед</a>";  // если есть ссылка Вперед
$browse_msg['next_none']  = "<a class='disabled' href='#'>Вперед</a>";  // если нет ссылки Вперед
$browse_msg['suffix'] = "</nav>";

Предположим, что внизу списка объектов нужно выводить постраничную навигацию по 15 ссылок (Страницы 1 2 3 ... 15). Фрагмент суффикса списка объектов компонента:

<?= browse_messages($cc_env, 15) ?>

← Назад 11.3 Шаблоны вывода данных 11.5 Системные настройки Далее →

Наверх