====== Теги шаблонной системы 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:core_tags:core_block_tag|<core:block>]]|Позволяет сгруппировать несколько тегов в один блок, а также показывать или скрывать этот блок.|
|[[.Tags:core_tags:core_comment_tag|<core:comment>]]|Позволяет вставить в шаблон комментарий, который полностью будет убрал на этапе компиляции из шаблона.|
|[[.Tags:core_tags:core_datasource_tag|<core:datasource>]]|Вставляет новый контейнер данных в шаблон.|
|[[.Tags:core_tags:core_optional_tag|<core:optional>]]|Выводит кусок шаблона, если указанная переменная имеет значимое значение во время выполнения шаблона.|
|[[.Tags:core_tags:core_default_tag|<core:default>]]|Выводит кусок шаблона, если указанная переменная не имеет значимое значение во время выполнения шаблона.|
|[[.Tags:core_tags:core_if_tag|<core:if>]]|Выводит кусок шаблона, если указанное в атрибуте exp wact-выражение можно привести к true.|
|[[.Tags:core_tags:core_include_tag|<core:include>]]|Вставляет содержимое другого шаблона или иного файла в текущий шаблон.|
|[[.Tags:core_tags:core_literal_tag|<core:literal>]]|Запрещает парсинг куска шаблона, содержащегося в рамках тега.|
|[[.Tags:core_tags:core_placeholder_tag|core:placeholder>]]|Представляет из себя место в шаблоне куда может быть вставлен другой шаблон.|
|[[.Tags:core_tags:core_repeat_tag|<core:repeat>]]|Позволяет повторить некоторую часть шаблона определенное количество раз.|
|[[.Tags:core_tags:core_runtime_content_tag|<core:runtimecontent>]]|Позволяет вставить в откомпилированный шаблон место для вывода текста, который можно будет задать на этапе выполнения шаблона.|
|[[.Tags:core_tags:core_wrap_tag|<core:wrap>]]| Вставляет часть шаблона в определенное место другого шаблона. Делает из этих двух шаблонов один - единый шаблон.|
|[[.Tags:core_tags:core_set_tag|<core:set>]]|Вставляет переменную в тот же контейнер данных, где находится тег.|
===== WACT List Tags (WACT теги для работы со списками) =====

^Тег^Описание^
|Расположение: **limb/wact/src/tags/list/**|||
|[[.tags:list_tags:list_list_tag|<list:list>]]| Основной тег для вывода списков. Содержит контейнер данных в виде итератора. **Пример использования здесь!**|
|[[.tags:list_tags:list_item_tag|<list:item>]]|Повторяет определенный кусок шаблона по количеству записей в контейнере данных списка тега <list:list>. **Пример использования здесь!**|
|%%{$:ListRowNumber}%%|Выводит порядковый номер записи в списке. Относится к тегу <list:item>|
|%%{$:ListRowOdd}%%|Имеет значение true, если ряд является нечетным. Относится к тегу <list:item>|
|%%{$:ListRowEven}%%|Имеет значение true, если ряд является четным. Относится к тегу <list:item>|
|%%{$:Parity}%%|Имеет значение even или odd, в зависимости от четности ряда. Относится к тегу <list:item>|
|[[.tags:list_tags:list_default_tag|<list:default>]]|Отображает свое содержимое, если контейнер данных списка пуст|
|[[.tags:list_tags:list_separator_tag|<list:separator>]]|Используется для разделения строк списка друг от друга|
|[[.tags:list_tags:list_fill_tag|<list:fill>]]|Используется для разделения строк списка друг от друга|
===== WACT Form tags (WACT теги для работы с формами и полями форм) =====
^Тег^Описание^
|Расположение: **limb/wact/src/tags/form/**|||
|[[.tags:form_tags:form_tag|<form>]]|Расширенная форма тега <form>|
|[[.tags:form_tags:form_errors_tag|<form:errors>]]|Используется для отображения списка ошибок валидации формы.|
|[[.tags:form_tags:control_tag|ControlTag]] (без тега) | Базовый класс тега для всех тегов, предназначенных для ввода данных.|
|[[.tags:form_tags:input_tag|<input>]]|Расширеная форма тега <input>.|
|[[.tags:form_tags:button_tag|<button>]]|Расширенная форма тега <button>.|
|[[.tags:form_tags:text_area_tag|<text_area>]]|Расширенная форма тега <textarea>.|
|[[.tags:form_tags:label_tag|<label>]] |Расширенная форма тега <label>.|
|[[.tags:form_tags:js_checkbox_tag|<js_checkbox>]]| Вставляет DHML checkbox, а также hidden поле, которое всегда возвращает какое-либо значение ('0' или '1').|
|[[.tags:form_tags:select_tag|<select>]] |Расширенная форма тега <select>.|
|[[.tags:form_tags:option_tag|<option>]] | Тег опции выбора для тега <select>.|
|[[.tags:form_tags:select_options_source_tag|<select:options_source>]] |Позволяет преобразовывать контейнеры данных в виде итераторов или обычные массивы в такую форму, которая понятна компонентам тега <select> для построения списка тегов <option>.|
|[[.tags:form_tags:form_multiple_tag|<form_multiple>]] | Является расширением к базовому тегу <form>, позволяет иметь несколько активных форм, которые обрабатываются одной страницей.|
|[[.tags:form_tags:form_referer_tag|<form:referer>]]| Вставляет в форму скрытое поле со значение $_SERVER["HTTP_REFERER"] или со значением переменной Запроса **referer**.|
|[[.tags:form_tags:form_preserve_state_tag|<form:preserve_state>]] | Позволяет указать прямо из шаблона, какие параметры запроса должны быть переданы через форму.|
===== Wact Pager tags (WACT теги для разбиения большого набора данных на страницы) =====

^Тег^Описание^
|Расположение **limb/wact/src/tags/pager/**|||
|[[.tags:pager_tags:pager_navigator_tag|<pager:navigator>]] | Основной тег для лимитирования итератора и вывода списка страниц. **Пример использования здесь!**|

|[[.tags:pager_tags:paginate_tag|<paginate>]] | Позволяет связывать pager со списком прямо в шаблоне.|
|[[.tags:pager_tags:pager_prev_tag|<pager:prev>]] | Позволяет вывести ссылку на предыдущую страницу списка страниц.|
|[[.tags:pager_tags:pager_first_tag|<pager:first>]] | Позволяет вывести ссылку на первую страницу списка страниц.|
|[[.tags:pager_tags:pager_next_tag|<pager:next>]] | Позволяет вывести ссылку на следующую страницу списка страниц.|
|[[.tags:pager_tags:pager_last_tag|<pager:last>]] | Позволяет вывести ссылку на последную страницу списка страниц.|
|[[.tags:pager_tags:pager_list_tag|<pager:list>]] | Выводит список страниц. |
|[[.tags:pager_tags:pager_number_tag|<pager:number>]] | Позволяет вывести ссылку на страницу списка страниц.|
|[[.tags:pager_tags:pager_current_tag|<pager:current>]] | Позволяет вывести ссылку на текущую страницу |
|[[.tags:pager_tags:pager_separator_tag|<pager:separator>]] | Выводит разделитель между страницами списка страниц.|
|[[.tags:pager_tags:pager_section_tag|<pager:section>]] | Позволяет вывести ссылку на группу страниц списка страниц.|
|[[.tags:pager_tags:pager_elipses_tag|<pager:elipses>]] | Позволяет вывести разделитель между группами ссылок на страницы в начале списка страниц, в середине и в конце pager-а.|
|**Свойства. Имеют отношение к тегу <pager:navigator>**||
|%%{$:TotalPages}%%|Содержит общее количество страниц.|
|%%{$:TotalItems}%%|Содержит общее количество элементов в списке.|
|%%{$:HasMoreThanOnePage}%%|Имеет значение true, если список содержит более одной страницы.|
|%%{$:BeginItemNumber}%%| Содержит номер записи, с которой начинается текущая страница.|
|%%{$:EndItemNumber}%%|Содержит номер записи, которой кончается текущая страница.|
===== WACT Request tags =====
^Тег^Описание^
|Расположение: **limb/wact/src/tags/request/**||
|[[.Tags:request_tags:site_branch_selector_tag|<site_branch_selector>]]|Группирует теги, которые позволяют выводить различные части шаблона, в зависимости от URL запроса. Полезен при создании шаблонов, которые должны выводить различный контент в различных разделах сайта.|
|[[.Tags:request_tags:site_branch_tag|<site_branch>]]| Позволяет выводить часть шаблона, если URL запроса содержит определенную подстроку.|
===== Wact Fetch tags (теги для получения данных прямо в WACT шаблонах) =====

^Тег^Описание^
|Расположение: **limb/wact/src/tags/fetch/**||
|[[.tags:fetch_tags:fetch_tag|<fetch>]]| Позволяет получать данные прямо в шаблонах при помощи классов, реализующих интерфейс %%WactFetcher%%.|
|[[.tags:fetch_tags:fetch_parameter_tag|<fetch:params>]]| Позволяет передать дополнительные параметры в объекты fetcher-ов, используемый в <fetch> теге.|
|[[.tags:fetch_tags:fetch_decorate_tag|<fetch:decorate>]]| Позволяет декорировать итератор, полученный при помощи <fetch> тега прямо в шаблоне.|
===== Limb Fetch tags (теги для получения данных прямо в WACT шаблонах) =====

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

^Тег^Описание^
|Расположение: **limb/wact/src/tags/iterator/**||
|[[.tags:iterator_tags:iterator_transfer_tag|<iterator:transfer>]]| Передает данные из одного компонента в другой.|
|[[.tags:iterator_tags:iterator_decorate_tag|<iterator:decorate>]] | Позволяет декорировать итераторы при передачи из одного компонента в другой, точно также как и <fetch:decorate> тег.|
===== Wact Perform tags (теги, используемые в шаблонах для вызова методов специальных helper-классов) =====

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

===== Limb Request tags =====
^Тег^Описание^
|Расположение: **limb/web_app/src/template/tags/request/**||
|[[.tags:lmb_request_tags:lmb_route_url_tag|<route_url>]] | Аналог тега <a>, но параметр href формируется при помощи класса [[limb3:ru:packages:web_app:lmb_routes|lmbRoutes]].|
|[[.tags:lmb_request_tags:lmb_route_url_set_tag|<route_url_set>]] | Позволяет вставлять в текущий контейнер данных ссылку, формируемую при помощи [[limb3:ru:packages:web_app:lmb_routes|lmbRoutes]].|
===== WACT Dev tags (WACT теги, используемые при разработке или отладке шаблонов или тегов) =====

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