__END__

Вложенные шаблоны

Что еще может пригодиться в работе с шаблонами? Любой сайт содержит повторяющиеся элементы дизайна – шапка, заголовки, меню и так далее.

Хороший движок шаблонов должен иметь возможность подключать более мелкие шаблоны (назовите их заготовками или библиотечными элементами) внутрь более крупных, желательно – поддерживать многоуровневое, вложенное подключение.

Чуть выше мы написали два шаблона для вывода таблицы. Логично не копировать этот код везде, где нам понадобится отобразить такую таблицу, а иметь возможность сохранить этот шаблон отдельно и подключать его по мере необходимости в другие шаблоны.

Обе наши библиотеки такую возможность предоставляют. В XTemplate существует конструкция:

{FILE "имя_вложенного_файла_шаблона"}

В HTML::Template аналогичные функции выполняет конструкция:

 <TMPL_INCLUDE NAME="имя_вложенного_файла_шаблона">

А вот здесь остановимся. Если вы посмотрите внимательно, то заметите, что мы вынуждены писать имя файла непосредственно в шаблоне. Это значит, что мы стали жестко привязаны к расположению файлов. Даже если мы укажем относительный путь к файлу шаблона, мы вынуждены будем в любом другом проекте в точности повторять структуру директорий для размещения шаблонов!

Это плохо. Более того, это как-то противоречит самой идее о легкости подключения (читай – переноса) и замыслу о повторном использовании более мелких (библиотечных) шаблонов.

Как можно выйти из ситуации? Например, иметь возможность единожды проинициализировать каталог размещения шаблонов в конструкторе класса. При наличии такой возможности мы можем один раз указать каталог шаблонов и в самих шаблонах уже не писать полный путь расположения вложенного шаблона. Вся настройка будет произведена в одном месте при вызове конструктора.

В случае HTML::Template эта возможность предусмотрена изначально. Обратите внимание, мы сразу использовали инициализацию каталога шаблонов в нашем примере:

my $template = HTML::Template->new(

     filename => "ex2.html",

     path => $ENV{DOCUMENT_ROOT}."/../data/htmltemp/"

);

В библиотеке XTemplate это не предусмотрено (во всяком случае в версии 0.2.4-3).

Сформировать имя файла шаблона динамически, написав нечто вроде:

{FILE "{TEMP_FILE}"}

и присвоить (проассоциировать) нужное значение подстановкой в {TEMP_FILE} тоже не выйдет. Конструктор класса производит рекурсивную inline-подстановку всех вложенных шаблонов, и только потом производит разбор и обработку полного шаблона со всеми подстановками.

Что делать? Отказаться от идеи повторного использования вложенных элементов? Ну не все так печально, как кажется. Библиотека XTemplate распространяется по лицензии GNU General Public License. Эта лицензия подразумевает возможность внесения изменений в исходный продукт при соблюдении определенных правил[1]. Нужные нам изменения ограничатся тремя строчками с добавлением комментариев.

Суть изменения сводится к добавлению еще одного члена класса и опциональной инициализации его в конструкторе. Этот новый член класса – path – будет определять путь к директории шаблонов. Остальные модификации в коде исходного класса ограничиваются конструктором и методом getfile(...).

class XTemplate {

...

/* Новый член класса */

var $path = "";

/***[ constructor ]*** /

function XTemplate ($file,$mainblock="main", $path="") {

  /* Инициализируем значение path, если соответствующий параметр не пуст */

  if ($path) $this->path= str_replace("\", "/", $path)."/";