====== <list:list> ======





===== Описание =====

Используется для вывода в шаблонах списков или таблиц. Для вывода данных компонент должен получить контейнер данных в виде итератора или массив (преобразование до итератора в WACT производится автоматически). Список будет выводиться в том случае, если контейнер данных содержит хотя бы один элемент. В противном случае будет выведено содержимое дочернего тега <list:default>, если он присутствует.

см. также раздел [[limb3:ru:packages:wact:list_tags|Вывод списков]], где есть подробная информация по работе со списочными данными в WACT-шаблонах.

<list:list> является тегом WactRuntimeComponentTag и создает активный компонент класса WactListComponent. 


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

<code xml>
<list:list id='id' [from='expression']>
...some content
</list:list>
</code>

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

В любом месте WACT шаблона.


===== Атрибуты =====

  * **id** - идентификатор списка. 
  * **from** - опционально. Выражение, обычно путь до переменной ([[limb3:ru:packages:wact:dbe|DBE]]), содержимое которой можно считать итератором (настоящий итератор или массив). Поддерживает краткую форму для значения, когда значок выражения опускается и используется только DBE.

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

Любые дочерние теги, такие как [[list_item_tag|<list:item>]], [[list_default_tag|<list:default>]], [[list_separator_tag|<list:separator>]] которые определяют, как будет выводиться список, а также теги разметки и любой другой текст.




===== WactListComponent =====

  * **registerDataset($dataset)** – позволяет установить контейнер данных из которого будет создан список.
  * **getOffset()** - возвращает позицию отступа от начала списка, начиная с которого выходятся данные. Используется свойством **{$%%ListRowNumber%%}** (см. тег [[list_item_tag|<list:item>]]).
  * Методы интерфейса **Iterator** (rewind, next, current, valid) для итерирования по контейнеру данных.

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

Рабочие примеры использования тегов и свойств группы List можно найти в папке **limb/wact/examples/tags/list/**.

<code xml>
<list:list id='photos'>
   <list:item>
     <img src='/images/{$image_name}' border=0/><br/><b>{$title}</b>
     <list:separator>
     <br/>
     </list:separator>
  <list:default>
  No items in the list!
 </list:default>
</list:list>
</code>

Выведет список изображений с заголовком. Если ни одного изображения нет, то будет выведена надпись "No items in the list!".

Данные в список могут быть поставлены несколькими путями:
  - Непосредственно в компонент из php-скрипта. см раздел [[limb3:ru:packages:wact:data_containers|"Контейнеры данных WACT"]]
  - Используя [[..:fetch_tags:fetch_tag|<fetch>]] тег. см. раздел [[limb3:ru:packages:wact:fetch_tags|"Использование тегов <fetch> и <active_record:fetch>"]].
  - Используя атрибут from или тег [[..:iterator_tags:iterator_transfer_tag|<iterator:transfer>]]. см. раздел [[limb3:ru:packages:wact:data_transfer|"Передача данных внутри шаблонов "]].