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

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


limb3:ru:packages:macro:tags:list_tags:list_tag

Тег {{list}}

Описание

Используется для вывода в шаблонах списков или таблиц. Список будет выводиться в том случае, если переменная, указанная при помощи атрибута using, содержит хотя бы один элемент. В противном случае будет выведено содержимое дочернего тега {{list:empty}}, если он присутствует.

Переменная, указанная в атрибуте using должна быть или массивом, или поддерживать интерфейс Iterator.

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

Синтаксис

{{list using='some_var' [as='item_var_name'] [key='original_key_name'] [counter='counter_var_name'] [parity='parity_var_name']}}
...some content
{{/list}}

Также имеет алиас {{list:list}}.

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

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

Атрибуты

  • using (или for) - переменная, содержимое которой будет выводиться в виде списка. Массив или итератор.
  • as - название переменной, которой будет присваиваться очередной элемент из списка. По-умолчанию имеет значение $item.
  • key - название переменной, в которой будет храниться оригинальный ключ из массива.
  • counter - название переменной, в которой будет храниться номер выводимого элемента.
  • parity - название переменной, в которой будет храниться значение четности выводимого элемента. Имеет значение even или odd.

Содержимое

Любые дочерние теги, такие как тег {{list:item}}, тег {{list:empty}}, тег {{list:glue}} которые определяют, как будет выводиться список, а также теги разметки и любой другой текст.

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

Задача: Взять список тегов из переменной $photo, определенной глобально в шаблоне, и вывести его в виде ненумерованного списка. Если ни одного тега нет, то вывести сообщение - «Нет тегов».

{{list using='{$#photo.tags}' as='$tag' counter='$my_counter' parity='$my_parity'}}
  <ul>
  {{list:item}}
    <li class="{$my_parity}">{$my_counter} - {$tag.title}</li>
  {{/list:item}}
  </ul>
  {{list:empty}}
  Нет тегов
  {{/list:empty}}  
{{/list}}

Обратите внимание, что если списка тегов в переменной $photo нет, то выводится только содержимое {{list:empty}} (теги <ul> и </ul> не будут выведены)

Обсуждение

Ваш комментарий. Вики-синтаксис разрешён:
   ____   __ __  _____  _      __ __  __
  / __/  / // / / ___/ | | /| / / \ \/ /
 / _/   / _  / / /__   | |/ |/ /   \  / 
/_/    /_//_/  \___/   |__/|__/    /_/
 
limb3/ru/packages/macro/tags/list_tags/list_tag.txt · Последние изменения: 2010/11/10 10:02 (внешнее изменение)