https://limb.nohau.ru/ 2026-11-10T16:18:29+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:ru:packages:macro:compiler&rev=1289372570&do=diff Как работает компилятор MACRO-шаблонов Цель этой страницы Эта страница будет полезной для разработчиков, которым необходимо создать свои собственные теги или фильтры. Она позволит понять, каким образом MACRO компилирует шаблоны. Мы подробно разберем процесс компиляции шаблонов, укажем на основные классы, участвующие в компиляции, покажем, как генерится php-код компилированных шаблонов, как отрабатывают выражения для вывода данных и т.д.… text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:ru:packages:macro:data_sources&rev=1289372570&do=diff Как MACRO-шаблон получает данные для вывода? MACRO всегде предполагает, что работает с литеральными переменными и массивами. Поэтому, если вы передаете в MACRO объекты, убедитесь, что они поддерживают интерфейсы text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:ru:packages:macro:dictionaries&rev=1289372570&do=diff Словари элементов MACRO-шаблона MACRO шаблонизатор поддерживает те теги и фильтры, которые находятся в так называемых словарях: * словарь тегов, text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:ru:packages:macro:diffs_from_wact&rev=1289372570&do=diff Отличия MACRO от WACT-а * MACRO не использует XML-подобный синтаксис для тегов. Благодаря этому MACRO-теги не теряются среди html-тегов, а также позволяет использовать MACRo-теги для генерации атрибутов обычных html-гов, что в WACT-е невозможно. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:ru:packages:macro: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:ru:packages:macro: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:ru:packages:macro:filters_intro&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:ru:packages:macro:filters&rev=1289372570&do=diff Фильтры шаблонной системы MACRO Фильтры для обработки текста clip Позволяет ограничить вывод длинной строки, указывая количество символов, и символы на границе. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:ru:packages:macro:form_tags&rev=1289372570&do=diff Теги форм и элементов форм MACRO содержит средства для решения проблемы автозаполнения полей формы после submit-а в том случае, если отправленные данные содержали ошибки (ошибки валидации). Стоит, правда, отметить, что в последнее время все большую популярность набирают различные средства для проведения валидации на стороне клиента или при помощи Ajax-запросов. Тем не менее, в данном разделе мы осветим некоторые моменты использования тегов группы FormTags, которые умеют генерить html-аналоги те… text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:ru:packages:macro:how_to_create_new_filter&rev=1289372570&do=diff Создание собственных {{macro}} фильтров Файл вашего нового класса должен быть расположен в одной из директорий вида src/macro и иметь имя some_filter_name.filter.php. Обратите внимание на окончание .filter.php. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:ru:packages:macro:how_to_create_new_tag&rev=1289372570&do=diff Создание собственных MACRO-тегов Мы предполагаем, что вам уже знакомы материалы следующих разделов: * "Компиляция и выполнение шаблона. Пример рендеринга MACRO-шаблона", * "Как работает компилятор MACRO-шаблонов", Теги хранятся в файлах с именем some_tag_name.tag.php, который должен быть расположен в одной из директорий вида src/macro пакетов или приложения, а также в папке /limb/macro/src/tags. Обратите внимание на окончание .tag.php - только их таких файлов информацию попадает в словарь… text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:ru:packages:macro:important_details&rev=1289372570&do=diff Компиляция и выполнение шаблона. Пример рендеринга MACRO-шаблона Фаза компиляции и фаза исполнения шаблонов Шаблонизатор Macro - является компилирующим обработчиком text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:ru:packages:macro:intro&rev=1289372570&do=diff Введение в шаблонную систему MACRO Шаблонизатор MACRO - это одновременно и мощный, и легко расширяемый, и быстрый инструмент php-разработчика для создания шаблонов. MACRO позволяет легко и чисто разделять презентационную логику от логики приложения, при этом не требует много времени на первоначальное освоение.… text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:ru:packages:macro:list_tags&rev=1289372570&do=diff Вывод списков MACRO-теги для вывода списков Для вывода списков в шаблонах используется группа тегов для работы со списками. <table border="1"> <tr> <th>№</th> <th>Название</th> <th>Объем, л</th> <th>Вес, кг</th> </tr> {{list using="$#tanks" as="$tank" counter="$number"}} {{list:item}} <tr> <td>{$number}</td> <td>{$tank.name}</td> <td>{$tank.volume}</td> <td>{$tank.weight}</td> </tr> {{/list:item}} {{list:empty}} <tr><td colspan='4'>Спи… text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:ru:packages:macro:pagination&rev=1289372570&do=diff Постраничный вывод данных в MACRO-шаблонах Чаще всего списки слишком длинные, чтобы их показывать на одной странице. Для решения этой проблемы применяют разбиение списков на страницы. Этот список страниц обычно называют пейджером (pager). text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:ru:packages:macro:php_code_in_templates&rev=1289372570&do=diff Использование php-кода в шаблонах Прежде всего нужно понимать, что MACRO компилирует шаблон в обычный php-класс. Поэтому MACRO позволяет вставлять любой php-код в шаблоны, например: text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:ru:packages:macro:pros_and_cons&rev=1289372570&do=diff Плюсы и минусы MACRO шаблонизатора Так как MACRO является в некоторой степени «наследником» WACT-а, мы позволили себе перенести сюда большинство плюсов последнего, а также добавить некоторые, которые характерные именно для MACRO. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:ru:packages:macro:tags&rev=1289372570&do=diff Теги шаблонной системы MACRO Большинство тегов имеет примеры использования. Если целая группа тегов содержит только один пример, то страница этого тега указана особо: text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:ru:packages:macro:template_composition&rev=1289372570&do=diff Композиция шаблонов: включение(include), обворачивание(wrap) и переиспользование(reuse) шаблонов Компиляция MACRO шаблонов MACRO содержит различные средства, которые позволяют собирать конечные шаблоны из набора других шаблонов: text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:ru:packages:macro:template_file_name_resolving&rev=1289372570&do=diff Как MACRO ищет шаблоны На данной странице мы не будем вдаваться в детали того, как поиск шаблонов реализован программно - лишь укажем принцип, на основе которого ищутся шаблоны. Отметим, что поиск шаблонов в базовом MACRO существенно отличается от поиска шаблонов, если используется MACRO совместно с пакетом VIEW.…