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

см. также раздел Вывод списков, где есть подробная информация по работе со списочными данными в WACT-шаблонах.

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

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

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

• id - идентификатор списка.
• from - опционально. Выражение, обычно путь до переменной (DBE), содержимое которой можно считать итератором (настоящий итератор или массив). Поддерживает краткую форму для значения, когда значок выражения опускается и используется только DBE.

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

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

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

<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>

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

Данные в список могут быть поставлены несколькими путями:

1. Непосредственно в компонент из php-скрипта. см раздел "Контейнеры данных WACT"
2. Используя <fetch> тег. см. раздел "Использование тегов <fetch> и <active_record:fetch>".
3. Используя атрибут from или тег <iterator:transfer>. см. раздел "Передача данных внутри шаблонов ".