Фремворк Limb

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

====== Постраничный вывод данных в WACT-шаблонах ======

Чаще всего списки слишком длинные, чтобы их показывать на одной странице. Для решения этой проблемы применяют разбиение списков на страницы. Этот список страниц обычно называют пейджером (pager).

Задача по разбиению длинных списков на страницы состоит из 2 под-задач:
  * Вывод pager-а.
  * Лимитирование списка, так что бы он содержал данные для текущей страницы. В случае с выборкой из базы данных - применение limit, offset.

===== Вывод pager-а =====

Для вывода pager-а используется группа тегов Pager Tags.

Приведем пример:

<pager:NAVIGATOR id="my_pager" items="10">
 
Показаны новости: с <b>{$BeginItemNumber}</b> по <b>{$EndItemNumber}</b>
 
<pager:FIRST><a href="{$href}">Первая страница </a></pager:FIRST>
 
<pager:LIST>
 
<pager:CURRENT><b><a href="{$href}">{$number}</a></b></pager:CURRENT>
<pager:NUMBER><a href="{$href}">{$number}</a></limb:pager:NUMBER>
 
</pager:LIST>
 
<pager:LAST><a href="{$href}">Последняя страница</a></pager:LAST>
 
Всего новостей: <b>{$TotalItems}</b>
</pager:NAVIGATOR>
</code>

Центральный тег при постраничном разбиении - [[.:tags:pager_tags:pager_navigator_tag|<pager:NAVIGATOR>]], который ограничивает пейджер. Он содержит атрибут **items**, который указывает, какое количество элементов списка выводить на одной странице.

Тег [[.:tags:pager_tags:pager_list_tag|<pager:list>]] - организует вывод номеров страниц pager-а.

Остальные теги
  * [[.:tags:pager_tags:pager_first_tag|<pager:FIRST>]] - выводит ссылку на первую страницу
  * [[.:tags:pager_tags:pager_prev_tag|<pager:PREV>]] - на предыдущую (здесь не использовался)
  * [[.:tags:pager_tags:pager_current_tag|<pager:CURRENT>]] - на текущую, 
  * [[.:tags:pager_tags:pager_next_tag|<pager:NEXT>]] - на следующую (здесь не использовался) 
  * [[.:tags:pager_tags:pager_last_tag|<pager:LAST>]] - на последнюю страницу
  * [[.:tags:pager_tags:pager_number_tag|<pager:NUMBER>]] - на страницу с определенным номером.

Внутри каждого тега доступна переменная **$href**, содержащая ссылку на нужную страницу. Теги <pager:NUMBER> и <pager:CURRENT> также содержат переменную **$number** - номер страницы.

Также внутри тега <pager:NAVIGATOR> доступны следующие предопределенные свойства:
  * **{$%%TotalItems%%}** - общее количество элементов в списке,
  * **{$%%BeginItemNumber%%}** - номер элемента, с которого начинается текущая страница,
  * **{$%%EndItemNumber%%}** - номер элемента, которым заканчивается текущая страница. 
  * **{$%%HasMoreThanOnePage%%}** - true, если страниц больше чем одна.

Обычно проекте реализуют один (или несколько) pager-ов, которые обычно подключаются к спискам по мере необходимости при помощи тега [[.:tags:core_tags:core_include_tag|<core:include>]].

===== Лимитирование списка =====

==== В php-скрипте ====

Допустим у нас есть шаблон:

<code xml>
<pager:navigator id="pager" items="5">
    <pager:first><a href='{$href}'>First</a></pager:first> <pager:prev><a href='{$href}'>Prev</a></pager:prev>
    <pager:list>
     [...]
    </pager:list>
    <pager:next><a href='{$href}'>Next</a></pager:next> <pager:last><a href='{$href}'>Last</a></pager:last>
</pager:navigator>

<list:LIST id='modules'>
  <TABLE width="100%" BORDER="1" ALIGN="CENTER">
    <list:ITEM>
      <TR>
        <TD>{$name}</TD>
        <TD>{$description|default:"&nbsp;"|raw}</TD>
      </TR>
    </list:ITEM>
  </TABLE>
</list:LIST>
</code>

Для связи pager-а со списком можно применить следующий код:

<code php>
$template = new WactTemplate('page.html');

$data = ...;// заполнение переменной data

$list = $template->findChild('modules');
$list->registerDataset($data); // Переводит $data в объектный вид, если необходимо

$pager = $template->getChild('pager', $dataset);
$dataset = $list->getDataset();
$pager->setPagedDataSet($dataset);
$dataset->paginate($pager->getStartingItem(), $pager->getItemsPerPage());

$template->display();
</code>

Если метод registerDataset() получает в качетве аргумента обычный массив, то он обворачивает его в WactArrayIterator, который поддерживает разбиение массива на страницы. В противном случае, аргумент метода registerDataset() должен поддерживать метод countPaginated() и paginate() для того, чтобы его можно было использовать с pager-ом (Базовые классы Limb поддерживают эти методы).

==== В шаблоне при помощи тега <paginate> ====

Связывать pager-ы и список в php-скрипте каждый раз довольно утомительно, поэтому начиная с версии WACT 0.3 стал доступен тег [[.:tags:pager_tags:paginate_tag|<paginate>]], который проводит связывание прямо в шаблоне.

Вот модифицированный код примеры с использованием тега <paginate>:

<pager:navigator id="pager" items="5">
    <pager:first><a href='{$href}'>First</a></pager:first> <pager:prev><a href='{$href}'>Prev</a></pager:prev>
    <pager:list>
     [...]
    </pager:list>
    <pager:next><a href='{$href}'>Next</a></pager:next> <pager:last><a href='{$href}'>Last</a></pager:last>
</pager:navigator>

<list:LIST id='modules'>
  <TABLE width="100%" BORDER="1" ALIGN="CENTER">
    <list:ITEM>
      <TR>
        <TD>{$name}</TD>
        <TD>{$description|default:"&nbsp;"|raw}</TD>
      </TR>
    </list:ITEM>
  </TABLE>
</list:LIST>
</code>

Теперь наш php-скрипт можно сделать намного короче:

<code php>
$template = new WactTemplate('page.html');

$data = ...;// заполнение переменной data

$template->setChildDataset('modules', $data);
$template->display();
</code>

Обратите внимание, что данные в списке должны быть до момента отработки тега <paginate>. Если вы используете WACT традиционным способом - данные ставятся напрямую в шаблон, то это не будет проблемой.

==== В шаблоне при помощи тегов <fetch> и <iterator:transfer>====

Если вы используете пакет WEB_APP и из него теги [[.:tags:fetch_tags:fetch_tag|<fetch>]] или [[.:tags:iterator_tags:iterator_transfer_tag|<iterator:transfer>]], тогда вы можете связать pager со списком при помощи атрибута **navigator**, например:

<pager:NAVIGATOR id="my_pager" items="10">
[...]
</limb:pager:NAVIGATOR>

<list:list id='news'>
[...]
</list:list>
</code>

Здесь действует только одно условие - контейнер данных, который получается из fetcher-а должен поддерживать метод **paginate($offset, $limit)**. В большинстве случаев, если вы используете пакеты Limb (DATASOURCE или DBAL), вам об этом не нужно думать.

===== А если страниц очень много? =====

Если у вас слишком много страниц (ну скажем больше 20), то можно применить 2 варианта:
  * Ввести разрывы (elipses) - когда отображаются страницы в начале, в середине и в конце списка страниц, а в остальных местах - пропуски. Это выглядит приблизительно так: 1-2-3...7-8-9-10-11...17-18-19
  * Ввести секции (sections) - некоторые блоки страниц, которые показывают только начальную и конечную страницы блока. Только 1 секция активна в текущий момент. Это выглядит приблизительно так: [1-5]6-7-8-9-10[11-15][16-19].

см. также описание тега [[.:tags:pager_tags:pager_navigator_tag|<pager:navigator>]].

==== Разрывы (elipses) ====

Для вывода разрывов используется тег [[limb3:ru:packages:wact:tags:pager_tags:pager_elipses_tag|<pager:elipses>]], а также атрибуты **pages_in_middle** и **pages_in_sides** тега <pager:navigator>.

Пример:

<code xml>
<pager:NAVIGATOR id="pager" items="5" pages_in_middle="5" pages_in_sides="3">
 
<pager:LIST>
<pager:CURRENT><b><a href="{$href}">{$number}</a></b></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>

==== Секции (sections) ====

Для вывода секций используется тег [[.:tags:pager_tags:pager_section_tag|<pager:section>]], а также атрибут **pages_per_section** тега <pager:navigator>.

Пример:
<code xml>
<pager:NAVIGATOR id="pager" items="5" pages_per_section="5">
 
<pager:LIST>
<pager:SECTION><a href="{$href}">[{$number_begin}..{$number_end}]</a></pager:SECTION>
<pager:CURRENT><b><a href="{$href}">{$number}</a></b></pager:CURRENT>
<pager:NUMBER><a href="{$href}">{$number}</a></pager:NUMBER>
<pager:SEPARATOR>-</pager:SEPARATOR>
</pager:LIST>

</pager:NAVIGATOR>
</code>

Внутри тега <pager:section> можно использовать переменные **$number_begin** и **$number_end**.

Выведет приблизительно следующий pager:
<code>
[1..5][6..10]11-12-13-14-15[16..17]
</code>

===== Отказ от вывода pager-а, если список содержит только 1 страницу =====

Тег [[.:tags:pager_tags:pager_navigator_tag|<pager:navigator>]] содержит предопределенное свойство **$%%HasMoreThanOnePage%%**. На основе данного свойства можно прятать остальное содержимое pager-а, если в списке всего одна страница:

<code xml>
<pager:NAVIGATOR id="site_pager" items="50">
<core:optional for='HasMoreThanOnePage'>
Всего в списке : {$TotalItems}. Показаны элементы: от <b>{$BeginItemNumber}</b> до <b>{$EndItemNumber}</b>

[...]
</core:optional>
</limb:pager:NAVIGATOR>
</code>

===== Дополнительные примеры =====

* Очень подробный пример использования группы тегов Pager Tags приведен на странице описание тега [[.:tags:pager_tags:pager_navigator_tag|<pager:navigator>]].
 * Рабочие примеры использование pager-ов см. в папке **limb/wact/examples/tag/pager/**.

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

   ____   ___   _      __     __   ____
  / __/  / _ | | | /| / / __ / /  / __/
 _\ \   / __ | | |/ |/ / / // /  _\ \  
/___/  /_/ |_| |__/|__/  \___/  /___/

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

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

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

Фремворк Limb

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

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

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