====== Теги шаблонной системы WACT (включая специфичные для Limb теги) ======

//Большинство тегов имеет примеры использования. Если целая группа тегов содержит только один пример, то страница этого тега указана особо: "Пример использования здесь!"//

Также примеры можно найти в репозитории по адресу: https://svn.limb-project.com/3.x/examples/wact/examples/. 

Их же можно скачать со страницы примеров Limb3: http://projects.limb-project.com/ (см. WACT template engine usage examples)



===== WACT Core Tags (Базовые теги WACT)=====

^Тег^Описание^
|Расположение: **limb/wact/src/tags/core/**||
|[[.Tags:CoreTags:coreBlockTag|<core:block>]]|Позволяет сгруппировать несколько тегов в один блок, а также показывать или скрывать этот блок.|
|[[.Tags:CoreTags:coreCommentTag|<core:comment>]]|Позволяет вставить в шаблон комментарий, который полностью будет убрал на этапе компиляции из шаблона.|
|[[.Tags:CoreTags:CoreDatasourceTag|<core:datasource>]]|Вставляет новый контейнер данных в шаблон.|
|[[.Tags:CoreTags:CoreOptionalTag|<core:optional>]]|Выводит кусок шаблона, если указанная переменная имеет значимое значение во время выполнения шаблона.|
|[[.Tags:CoreTags:CoreDefaultTag|<core:default>]]|Выводит кусок шаблона, если указанная переменная не имеет значимое значение во время выполнения шаблона.|
|[[.Tags:CoreTags:CoreIfTag|<core:if>]]|Выводит кусок шаблона, если указанное в атрибуте exp wact-выражение можно привести к true.|
|[[.Tags:CoreTags:CoreIncludeTag|<core:include>]]|Вставляет содержимое другого шаблона или иного файла в текущий шаблон.|
|[[.Tags:CoreTags:CoreLiteralTag|<core:literal>]]|Запрещает парсинг куска шаблона, содержащегося в рамках тега.|
|[[.Tags:CoreTags:CorePlaceholderTag|core:placeholder>]]|Представляет из себя место в шаблоне куда может быть вставлен другой шаблон.|
|[[.Tags:CoreTags:coreRepeatTag|<core:repeat>]]|Позволяет повторить некоторую часть шаблона определенное количество раз.|
|[[.Tags:CoreTags:coreRuntimeContentTag|<core:runtimecontent>]]|Позволяет вставить в откомпилированный шаблон место для вывода текста, который можно будет задать на этапе выполнения шаблона.|
|[[.Tags:CoreTags:CoreWrapTag|<core:wrap>]]| Вставляет часть шаблона в определенное место другого шаблона. Делает из этих двух шаблонов один - единый шаблон.|
|[[.Tags:CoreTags:CoreSetTag|<core:set>]]|Вставляет переменную в тот же контейнер данных, где находится тег.|

===== WACT List Tags (WACT теги для работы со списками) =====

^Тег^Описание^
|Расположение: **limb/wact/src/tags/list/**|||
|[[.tags:ListTags:ListListTag|<list:list>]]| Основной тег для вывода списков. Содержит контейнер данных в виде итератора. **Пример использования здесь!**|
|[[.tags:ListTags:ListItemTag|<list:item>]]|Повторяет определенный кусок шаблона по количеству записей в контейнере данных списка тега <list:list>. **Пример использования здесь!**|
|{$:ListRowNumber}|Выводит порядковый номер записи в списке. Относится к тегу <list:item>|
|{$:ListRowOdd}|Имеет значение true, если ряд является нечетным. Относится к тегу <list:item>|
|{$:ListRowEven}|Имеет значение true, если ряд является четным. Относится к тегу <list:item>|
|{$:Parity}|Имеет значение even или odd, в зависимости от четности ряда. Относится к тегу <list:item>|
|[[.tags:ListTags:ListDefaultTag|<list:default>]]|Отображает свое содержимое, если контейнер данных списка пуст|
|[[.tags:ListTags:ListSeparatorTag|<list:separator>]]|Используется для разделения строк списка друг от друга|
|[[.tags:ListTags:ListFillTag|<list:fill>]]|Используется для разделения строк списка друг от друга|

===== WACT Form tags (WACT теги для работы с формами и полями форм) =====
^Тег^Описание^
|Расположение: **limb/wact/src/tags/form/**|||
|[[.tags:FormTags:FormTag|<form>]]|Расширенная форма тега <form>|
|[[.tags:FormTags:FormErrorsTag|<form:errors>]]|Используется для отображения списка ошибок валидации формы.|
|[[.tags:FormTags:ControlTag|ControlTag]] (без тега) | Базовый класс тега для всех тегов, предназначенных для ввода данных.|
|[[.tags:FormTags:InputTag|<input>]]|Расширеная форма тега <input>.|
|[[.tags:FormTags:ButtonTag|<button>]]|Расширенная форма тега <button>.|
|[[.tags:FormTags:TextAreaTag|<text_area>]]|Расширенная форма тега <textarea>.|
|[[.tags:FormTags:LabelTag|<label>]] |Расширенная форма тега <label>.|
|[[.tags:FormTags:JsCheckboxTag|<js_checkbox>]]| Вставляет DHML checkbox, а также hidden поле, которое всегда возвращает какое-либо значение ('0' или '1').|
|[[.tags:FormTags:SelectTag|<select>]] |Расширенная форма тега <select>.|
|[[.tags:FormTags:OptionTag|<option>]] | Тег опции выбора для тега <select>.|
|[[.tags:FormTags:SelectOptionsSourceTag|<select:options_source>]] |Позволяет преобразовывать контейнеры данных в виде итераторов или обычные массивы в такую форму, которая понятна компонентам тега <select> для построения списка тегов <option>.|
|[[.tags:FormTags:FormMultipleTag|<form_multiple>]] | Является расширением к базовому тегу <form>, позволяет иметь несколько активных форм, которые обрабатываются одной страницей.|
|[[.tags:FormTags:FormRefererTag|<form:referer>]]| Вставляет в форму скрытое поле со значение $_SERVER["HTTP_REFERER"] или со значением переменной Запроса **referer**.|
|[[.tags:FormTags:FormPreserveStateTag|<form:preserve_state>]] | Позволяет указать прямо из шаблона, какие параметры запроса должны быть переданы через форму.|




===== Wact Pager tags (WACT теги для разбиения большого набора данных на страницы) =====

^Тег^Описание^
|Расположение **limb/wact/src/tags/pager/**|||
|[[.tags:PagerTags:PagerNavigatorTag|<pager:navigator>]] | Основной тег для лимитирования итератора и вывода списка страниц. **Пример использования здесь!**|
|[[.tags:PagerTags:PaginateTag|<paginate>]] | Позволяет связывать pager со списком прямо в шаблоне.|
|[[.tags:PagerTags:PagerPrevTag|<pager:prev>]] | Позволяет вывести ссылку на предыдущую страницу списка страниц.|
|[[.tags:PagerTags:PagerFirstTag|<pager:first>]] | Позволяет вывести ссылку на первую страницу списка страниц.|
|[[.tags:PagerTags:PagerNextTag|<pager:next>]] | Позволяет вывести ссылку на следующую страницу списка страниц.|
|[[.tags:PagerTags:PagerLastTag|<pager:last>]] | Позволяет вывести ссылку на последную страницу списка страниц.|
|[[.tags:PagerTags:PagerListTag|<pager:list>]] | Выводит список страниц. |
|[[.tags:PagerTags:PagerNumberTag|<pager:number>]] | Позволяет вывести ссылку на страницу списка страниц.|
|[[.tags:PagerTags:PagerCurrentTag|<pager:current>]] | Позволяет вывести ссылку на текущую страницу |
|[[.tags:PagerTags:PagerSeparatorTag|<pager:separator>]] | Выводит разделитель между страницами списка страниц.|
|[[.tags:PagerTags:PagerSectionTag|<pager:section>]] | Позволяет вывести ссылку на группу страниц списка страниц.|
|[[.tags:PagerTags:PagerElipsesTag|<pager:elipses>]] | Позволяет вывести разделитель между группами ссылок на страницы в начале списка страниц, в середине и в конце pager-а.|
|**Свойства. Имеют отношение к тегу <pager:navigator>**||
|{$:TotalPages}|Содержит общее количество страниц.|
|{$:TotalItems}|Содержит общее количество элементов в списке.|
|{$:HasMoreThanOnePage}|Имеет значение true, если список содержит более одной страницы.|
|{$:BeginItemNumber}| Содержит номер записи, с которой начинается текущая страница.|
|{$:EndItemNumber}|Содержит номер записи, которой кончается текущая страница.|


===== WACT Request tags =====
^Тег^Описание^
|Расположение: **limb/wact/src/tags/request/**||
|[[.Tags:RequestTags:SiteBranchSelectorTag|<site_branch_selector>]]|Группирует теги, которые позволяют выводить различные части шаблона, в зависимости от URL запроса. Полезен при создании шаблонов, которые должны выводить различный контент в различных разделах сайта.|
|[[.Tags:RequestTags:SiteBranchTag|<site_branch>]]| Позволяет выводить часть шаблона, если URL запроса содержит определенную подстроку.|



===== Wact Fetch tags (теги для получения данных прямо в WACT шаблонах) =====

^Тег^Описание^
|Расположение: **limb/wact/src/tags/fetch/**||
|[[.tags:FetchTags:FetchTag|<fetch>]]| Позволяет получать данные прямо в шаблонах при помощи классов, реализующих интерфейс WactFetcher.|
|[[.tags:FetchTags:FetchParameterTag|<fetch:params>]]| Позволяет передать дополнительные параметры в объекты fetcher-ов, используемый в <fetch> теге.|
|[[.tags:FetchTags:FetchDecorateTag|<fetch:decorate>]]| Позволяет декорировать итератор, полученный при помощи <fetch> тега прямо в шаблоне.|

===== Limb Fetch tags (теги для получения данных прямо в WACT шаблонах) =====

^Тег^Описание^
|Расположение: **limb/web_app/src/template/tags/fetch/**||
|[[.tags:lmbFetchTags:lmbActiveRecordFetchTag|<active_record:fetch>]]| Аналог <fetch> тега, но в качестве источника данных использует классы lmbActiveRecord.|
|[[.tags:lmbFetchTags:lmbFindParamsTag|<find:params>]]| Аналог <fetch:param>, позволяющий задать любые параметры для find-метода при использовании тега <active_record:fetch>.|

===== Wact Iterator tags (теги, используемые в шаблонах для передачи и декорирования итераторов) =====

^Тег^Описание^
|Расположение: **limb/wact/src/tags/iterator/**||
|[[.tags:IteratorTags:IteratorTransferTag|<iterator:transfer>]]| Передает данные из одного компонента в другой.|
|[[.tags:IteratorTags:IteratorDecorateTag|<iterator:decorate>]] | Позволяет декорировать итераторы при передачи из одного компонента в другой, точно также как и <fetch:decorate> тег.|

===== Wact Perform tags (теги, используемые в шаблонах для вызова методов специальных helper-классов) =====

^Тег^Описание^
|Расположение: **limb/web_app/src/template/tags/perform/**||
|[[.tags:PerformTags:PerformTag|<perform>]]| Описывает вызов произвольного метода специального класса, которые условно называются шаблонными командами (WactTemplateCommand). При помощи тега <perform> по сути можно встроить в шаблон любой кусок php-кода, который может каким-либо образом влиять на шаблон. Например, выстанавливать количество элементов в pager-е, загружать данные, выставлять те или иные переменные.|
|[[.tags:PerformTags:PerformParamsTag|<perform:params>]] | Позволяет передать любое количество параметров в вызов метода, который описывается тегом <perform>.|

===== Limb Request tags =====
^Тег^Описание^
|Расположение: **limb/web_app/src/template/tags/request/**||
|[[.tags:lmbRequestTags:lmbRouteUrlTag|<route_url>]] | Аналог тега <a>, но параметр href формируется при помощи класса [[limb3_2007_4:ru:packages:web_app:lmbRoutes|lmbRoutes]].|
|[[.tags:lmbRequestTags:lmbRouteUrlSetTag|<route_url_set>]] | Позволяет вставлять в текущий контейнер данных ссылку, формируемую при помощи [[limb3_2007_4:ru:packages:web_app:lmbRoutes|lmbRoutes]].|

===== WACT Dev tags (WACT теги, используемые при разработке или отладке шаблонов или тегов) =====

^Тег^Описание^
|Расположение: **limb/wact/src/tags/dev/**||
|[[.tags:DevTags:DevDataSpaceTag|<dev:dataspace>]] | Выводит содержимое обычного контейнера данных.|
|[[.tags:DevTags:DevSourceTag|<dev:source>]] | Выводит кусок скомпилированного кода куска шаблона, заключенного в рамки тега. Удобен при разработке новых тегов.|