Фремворк Limb

Отредактируйте страницу и нажмите «Сохранить». Прочтите справочную страницу для ознакомления с синтаксисом вики. Пожалуйста, редактируйте только в том случае, если планируете улучшить содержимое. Если вы просто хотите потестировать что-либо, воспользуйтесь специальной страницей: PlayGround.

====== <pager:navigator> ======
===== Описание =====

<pager:navigator> позволяет лимитировать итераторы и выводить так называемый **pager**, то есть список страниц со ссылками.

WACT pager поддерживает 2 способа вывода большого количества ссылок:
 - режим **elipses**, когда выводится только несколько страниц вокруг текущей и некоторое количество страниц в начале и в конце списка (см. тег <pager:elipses>). Список страниц будет выглядеть приблизительно так: 1-2-3...7-8-9...20-21-22. Этот режим предпочтительнее, когда для пользователя по сути не важно попасть на какую-то определенную страницу. 
 - режим **sections** (секции), которые можно понимать как страницы страниц. Список страниц будет выглядеть приблизительно так: [1-10][11-20]21-22-23-24-25-26-27-28-29-30[31-40][40-47]

Выделяют следующие элементы pager-а:
 * Ссылка на первую страницу. Тег [[pager_first_tag|<pager:first>]]
 * Ссылка на предыдущую страницу. Тег [[pager_prev_tag|<pager:prev>]]
 * Ссылка на страницу. Тег [[pager_number_tag|<pager:number>]]
 * Ссылка на текущую страницу. Тег [[pager_current_tag|<pager:current>]]
 * Ссылка на секцию. Тег [[pager_section_tag|<pager:section>]]
 * Ссылка на следующую страницу. Тег [[pager_next_tag|<pager:next>]]
 * Ссылка на последнуюю страницу. Тег [[pager_last_tag|<pager:last>]]
 * Начальный элемент (номер), выводимый на текущей странице. Св-во **%%BeginItemNumber%%**
 * Конечный элемент (номер), выводимый на текущей странице. Св-во **%%EndItemNumber%%**
 * Общее количество элементов. Св-во **%%TotalItems%%**
 * Общее количество страниц. Св-во **%%TotalPages%%**
 * Признак, что pager содержит более одной страницы. Св-во **%%HasMoreThanOnePage%%**

Вывод pager-а достаточно гибко настраивается.

см. также разделы 
 * [[limb3:ru:packages:wact:pagination|"Постраничный вывод данных в WACT-шаблонах"]]
 * [[limb3:ru:packages:wact:tags:pager_tags:paginate_tag|<paginate>]] - тег, позволяющий связывать pager со списком прямо в WACT-шаблоне.

===== Синтаксис =====

<code xml>
<pager:navigatorid='id' items='items_per_page' [pages_per_section='pages_per_section'] [pager_prefix='prefix'] [pages_in_middle='pages_in_middle'] [pages_in_sides='pages_in_sides'] [mirror='main_pager_id']/>
__some_chil_tags_with_decorating_content__
</pager:navigator>
</code>

===== Область применения =====

В любом месте WACT шаблона.
===== Атрибуты =====

* **id** - идентификатор тега.
 * **items** - позволяет указать, сколько записей из итератора должно выводиться на одной странице.
 * **pages_per_section** - позволяет указать, сколько страниц должно находиться в одной секции. Атрибут учитывается, если внутри нет тега [[pager_elipses_tag|<pager:elipses>]].
 * **pages_in_middle** - позволяет указать количество страниц в центре pager-а, включая текущую страницу. Атрибут учитывается, если используется тег [[pager_elipses_tag|<pager:elipses>]].
 * **pages_in_sides** - позволяет указать количество страниц по бокам pager-а. Атрибут учитывается, если используется тег [[pager_elipses_tag|<pager:elipses>]].
 * **pager_prefix** - позволяет указать префикс, который будет использовать при передаче информации о текущей странице в запросах. Использование этого параметра позволяет использовать сразу несколько pager-ов на одной странице.
 * **mirror** - позволяет указать идентификатор pager-а, который будет использоваться как ведущий для текущего pager-а. Это позволяет вывести 2-pager-а, которые могут друг друга дублировать.

===== Содержимое =====

Дочерние теги, плюс элементы оформления.
===== Список доступных свойств =====

===== Пример использования =====

Рабочие примеры можно найти в папке **limb/wact/examples/tags/pager/**.

==== Pager с секциями ====

Total items : {$TotalItems}. Shown: from {$BeginItemNumber} to {$EndItemNumber}

<pager:FIRST><a href="{$href}">First</a></pager:FIRST>
<pager:PREV><a href="{$href}">First</a></pager:PREV>

<pager:LIST>
<pager:SECTION><a href="{$href}">[{$number_begin}..{$number_end}]</a></pager:SECTION>
<pager:CURRENT><a href="{$href}">{$number}</a></pager:CURRENT>
<pager:NUMBER><a href="{$href}">{$number}</a></pager:NUMBER>
<pager:SEPARATOR>-</pager:SEPARATOR>
</pager:LIST>

<pager:NEXT><a href="{$href}">Next</a></pager:NEXT>
<pager:LAST><a href="{$href}">Last</a></pager:LAST>

</pager:NAVIGATOR>

</code>

Выведет приблизительно вот такой pager:

<code>
 Total items : 174. Shown: from 121 to 130.
 First Prev [1..5][6..10]11-12-13-14-15[16..17] Next Last
</code>

==== Pager с elipses ====

<pager:LIST>
<pager:CURRENT><a href="{$href}">{$number}</a></pager:CURRENT>
<pager:NUMBER><a href="{$href}">{$number}</a></pager:NUMBER>
<pager:ELIPSES>...</pager:ELIPSES>
<pager:SEPARATOR>-</pager:SEPARATOR>
</pager:LIST>

</pager:NAVIGATOR>

</code>

Выведет приблизительно вот такой pager:

<code>
 1-2-3...6-7-8-9-10...15-16-17
</code>
==== Cкрытие пустого pager-а ====

Для скрытия содержимого pager-а можно использовать св-во **%%HasMoreThanOnePage%%** совместно с тегов <core:optional>:

<core:optional for='HasMoreThanOnePage '>

Total items : {$TotalItems}. Shown: from {$BeginItemNumber} to {$EndItemNumber}

<pager:LIST>
<pager:CURRENT><a href="{$href}">{$number}</a></pager:CURRENT>
<pager:NUMBER><a href="{$href}">{$number}</a></pager:NUMBER>
<pager:ELIPSES>...</pager:ELIPSES>
<pager:SEPARATOR>-</pager:SEPARATOR>
</pager:LIST>

</core:optional>

</pager:NAVIGATOR>

</code>

Пожалуйста, введите код подтверждения, чтобы доказать, что вы не робот:

 ______  __  __   __   _   __   ___ 
/_  __/ / / / /  / /  | | / /  / _ )
 / /   / /_/ /  / /__ | |/ /  / _  |
/_/    \____/  /____/ |___/  /____/

Пожалуйста, оставьте это поле пустым:

Сводка изменений

Примечание: редактируя эту страницу, вы соглашаетесь на использование своего вклада на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International

Фремворк Limb

Инструменты пользователя

Инструменты сайта

Инструменты страницы