https://limb.nohau.ru/ 2026-11-10T16:23:51+00:00 https://limb.nohau.ru/ https://limb.nohau.ru/lib/exe/fetch.php?media=wiki:dokuwiki.svg text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:compiler&rev=1289372570&do=diff Как работает компилятор WACT-шаблонов Цель этой страницы Эта страница будет полезной для разработчиков, которым необходимо создать свои собственные теги или фильтры. Она позволит понять, каким образом WACT-компилирует шаблоны. Мы подробно разберем процесс компиляции шаблонов, укажем на основные классы, участвующие в компиляции, покажем, как генерится php-код компилированных шаблонов, как отрабатывают выражения для вывода данных и т.д.… text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:data_containers&rev=1289372570&do=diff Контейнеры данных WACT. Какие данные можно передавать в WACT-шаблоны Под контейнером данных в WACT шаблоне мы понимаем такой активный компонент откомпилированного шаблона, который предоставляет для остальных доступ к некоторым данным. Контейнеры данных в откомпилированном шаблоне формируют дерево. Это должно быть вам знакомо по материалам разделов:… text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:data_transfer&rev=1289372570&do=diff Передача данных внутри шаблонов WACT предоставляет средства по перемещению данных внутри шаблона. Допустим, у нас есть контейнер с данными по автору, и нам необходимо вывести список всех книг этого автора (при помощи <list:list>). Конечно, можно отдельно передать данные сначала в первый контейнер, а затем во второй, но эти операции можно делать непосредственно в шаблоне.… text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:dbe&rev=1289372570&do=diff DBE. Data Binding Expressions Data Binding Expressions - это термин, который используется в WACT для точного указания, какая именно переменная должна быть использована. К сожалению, мы пока не выработали русский термин для этого понятия, поэтому часто используем просто - text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:dictionaries&rev=1289372570&do=diff Словари элементов WACT-шаблона WACT шаблонизатор поддерживает те теги, фильтры и преопределенные свойства, которые находятся в так называемых словарях: text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:errors_and_debug&rev=1289372570&do=diff Отладка шаблонов Ошибки компиляции шаблонов Шаблонная система способна с большинстве случаев самостоятельно находить многие ошибки в шаблонах. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:expressions&rev=1289372570&do=diff Выражения. Вывод значений переменных в шаблоне. Данная страница предполагает, что Вам знакомы следующие понятия: * что такое выражения и фильтры. Начальные сведения об этих элементах можно получить из раздела text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:fetch_tags&rev=1289372570&do=diff Использование fetch и active_record:fetch тегов-ов в WACT-шаблонах Что такое fetcher-ы Fetcher-ы используются для получения данных непосредственно из WACT-шаблонов. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:filters_intro&rev=1289372570&do=diff Фильтры Фильтры - предназначены для модифицирования значения переменной или строки при выводе в шаблон при помощи [.expressions|выражений]]. Фильтры отделяются от остальной части выражения вертикальным разделителем. Несколько фильтров в выражении разделяются также вертикальным разделителем:… text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:filters&rev=1289372570&do=diff Фильтры шаблонной системы WACT (включая специфичные для Limb фильтры) WACT Core Filters (Базовые фильтры WACT) Описание фильтров содержат примеры. Рабочие примеры применения фильтров можно найти в папке text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:form_tags&rev=1289372570&do=diff Теги форм с активными компонентами или без Роль атрибута runat Любой тег в WACT шаблоне при желании может иметь активный компонент фазы выполнения. Для этого существует специальный атрибут text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:how_to_create_new_filter&rev=1289372570&do=diff Создание собственных фильтров WACT Чтобы создать свой собственный фильтр, вы должны создать свой собственный класс, имеющий тип WactCompilerFilter (limb/wact/src/compiler/filter/WactCompilerFilter.class.php). text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:how_to_create_new_tag_property&rev=1289372570&do=diff Создание собственных предопределенных св-в Предопределенные св-ва - это образно говоря переменные, которые определены на этапе выполнения шаблона только в рамках (внутри) определенных тегов. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:how_to_create_new_tag&rev=1289372570&do=diff Создание собственных WACT тегов Мы предполагаем, что вам уже знакомы материалы следующих разделов: * "Как работает компилятор WACT-шаблонов", * "Типы тегов" То есть вам должны быть знакомо следующее: text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:how_to_run_wact_only&rev=1289372570&do=diff Рендеринг WACT шаблона. Использование пакета WACT Использование пакета WACT отдельно, отличается от его использования с пакетом WEB_APP, поэтому мы выделили отдельный раздел. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:how_to_run_with_web_app&rev=1289372570&do=diff Рендеринг WACT шаблона. WEB_APP и WACT пакеты Работа из контроллера Limb в качестве View использует по-умолчанию шаблонизатор WACT. Вы можете установить, какой шаблон использовать при помощи метода lmbWactView :: setTemplate($template_name). После этого мы можете получить доступ к любому активному компоненту WACT шаблона:… text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:important_details&rev=1289372570&do=diff Компиляция и выполнение шаблона. Активные компоненты шаблона. Дерево контейнеров данных. Цели и задачи раздела Цель - дать необходимые знания о том, как работает шаблонизатор WACT: text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:intro&rev=1289372570&do=diff Введение в шаблонную систему WACT Первоначально, WACT (Web Application Component Toolkit ) - это другой фреймворк, как и Limb. Однако уже долгое время этот проект активно не развивается, и, чтобы хорошие идеи не пропадали зря, мы адаптировали некоторые его составляющие под свои нужды, в частности DBAL, VALIDATION и собственно сам шаблонизатор.… text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:list_tags&rev=1289372570&do=diff Вывод списков WACT-теги для вывода списков Для вывода списков в шаблонах используется группа тегов ListTags. <table border="1"> <tr> <th>№</th> <th>Название</th> <th>Объем, л</th> <th>Вес, кг</th> </tr> <list:list id="table"> <list:item> <tr> <td>{$ListRowNumber}</td> <td>{$name}</td> <td>{$volume}</td> <td>{$weight}</td> </tr> </list:item> <list:default> <tr><td colspan='4'>Список пуст!</td></tr> </list:default> </list:list> </tabl… text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:pagination&rev=1289372570&do=diff Постраничный вывод данных в WACT-шаблонах Чаще всего списки слишком длинные, чтобы их показывать на одной странице. Для решения этой проблемы применяют разбиение списков на страницы. Этот список страниц обычно называют пейджером (pager). text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:php_code_in_templates&rev=1289372570&do=diff Использование php-кода в шаблонах WACT позволяет вставлять любой php-код в шаблоны, например: <select name='my_selector'> <?php foreach($items as $item) { echo '<option value="'. $item['value'] . '" '; if(some_condition()) echo 'selected'; echo '>'. $item['title'] .'</option>'; } ?> </select> text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:pros_and_cons&rev=1289372570&do=diff Плюсы и минусы WACT шаблонизатора Плюсы WACT * WACT использует декларативную логику описания. То есть WACT-шаблоны - это html-документы с вкраплениями XML-тегов. Никакого дополнительного синтаксиса, обучение происходит очень быстро. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:rules&rev=1289372570&do=diff Правила и ограничения, применяемые к WACT-шаблонам Сбалансированность шаблонов В WACT действует правило обязательности сбалансированности шаблонов, то есть каждый тег должен иметь закрывающий тег. Это касается как обычных html-тегов, так и WACT-тегов. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:runtime_api&rev=1289372570&do=diff API шаблона на этапе выполнения Класс WactTemplate - это потомок от WactRuntimeComponentDatasource, который в свою очередь наследуется от WactRuntimeComponent. Поэтому он поддерживает методы активного компонента и методы контейнера данных, а также набор других, упрощающих работу с шаблоном на этапе выполнения.… text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:select_tags&rev=1289372570&do=diff Использование select тегов. <select> теги используются для выбора какого-либо значения из списка доступных. Вам должно быть уже известно, что для некоторых тегов атрибут runat определяет, создается ли активный компонент для тега или нет. см. раздел text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:tag_types&rev=1289372570&do=diff Типы тегов шаблонной системы WACT В шаблонной системе WACT существует несколько основных типов тегов. Сравнительная таблица типов тегов Тип тега text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:tags&rev=1289372570&do=diff Теги шаблонной системы WACT (включая специфичные для Limb теги) Большинство тегов имеет примеры использования. Если целая группа тегов содержит только один пример, то страница этого тега указана особо: text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:template_commands&rev=1289372570&do=diff "Шаблонные команды" Краткое описание Термин «шаблонные команды» пока взят в кавычки, так как это рабочее название, окончальный термин еще не определен. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:template_composition&rev=1289372570&do=diff Композиция шаблонов: включение(include) и обворачивание(wrap) шаблонов Компиляция WACT шаблонов WACT содержит различные средства, которые позволяют собирать конечные шаблоны из набора других шаблонов: text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:template_file_name_resolving&rev=1289372570&do=diff Как WACT ищет шаблоны На данной страницы мы не будем вдаваться в детали того, как поиск шаблонов реализован программно - лишь укажем принцип, на основе которого ищутся шаблоны. Отметим, что поиск шаблонов в базовом WACT существенно отличается от поиска шаблонов, если используется WACT совместно с пакетом WEB_APP.… text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_2:ru:usage:wact:using_decorators_for_iterators&rev=1289372570&do=diff Декорирование данных в WACT-шаблонах. Под декорированием мы подразумеваем применение шаблона декоратор (Decorator или Wrapper) для данных, которые мы получили из какого-то источника данных.