Mercurial > pub > Impl
diff Lib/IMPL/Web/View/TTDocument.pm @ 304:2ff513227cb4
*TTView: refactoring. Added control registry for the document.
author | cin |
---|---|
date | Mon, 15 Apr 2013 07:44:50 +0400 |
parents | a5eb64c6e6f7 |
children | b5d5793f348e |
line wrap: on
line diff
--- a/Lib/IMPL/Web/View/TTDocument.pm Mon Apr 08 02:18:47 2013 +0400 +++ b/Lib/IMPL/Web/View/TTDocument.pm Mon Apr 15 07:44:50 2013 +0400 @@ -162,199 +162,13 @@ =begin code -use IMPL::Web::View::TTDocument(); - -my $doc = new IMPL::Wbe::View::TTDocument($template,$ttOptions); - -return $doc->Render(); =end code -Однако, более предпочтительный способ использовать C<IMPL::Web::View::TTLoader>. - =head1 DESCRIPTION -Документ для представления данных. Документы представляют собой иерархически организованные данные, -элементами данного документа являются данные для отображения, такие как - -=over - -=item * Объекты из БД - -=item * Навигационные цепочки - -=item * Меню и т.п. - -=back - -Скприт шаблона формирует структуру документа, затем сформированная структура форматируется в готовый документ. -Процесс форматирования объектной модели в готовый документ может быть выполнена как вручную, так и при помощи -вспомогательного шаблона - обертки. Если у шаблона документа указан C<layout> в метаданных, то он будет -использован как шаблон для форматирования объектной модели, вывод самого шаблона будет проигнорирован. Если -обертка не задана, то результатом будет вывод самого скрипта шаблона. - -Использование объектной модели документа позволяет решить задачи по созданию контейнеров, -у которых может быть сложное содежимое. Примером таких элементов могут быть формы, -внутри форм элементы управления также могут группироваться. - -=head2 Элементы управления (компоненты) - -Документ состоит из узлов, часть которых наследуется от C<IMPL::Web::View::TTControl>, такие узлы называются -элементами управления. Каждый элемент управления имеет собственный контекст, который наследуется от контекста -документа. - -=head2 Фабрика элементов управления - -Для создания элементов управления используются фабрики. Каждый элемен управления имеет свой шаблон для -форматиорвания содержимого, фабрика связывает шаблон и класс элемента управления, для чего при загрузке -шаблона используется свойство C<type> из метаданных. Фабрика загружается в документ при том только один -раз, повторные загрузки фабрики возвращают уже загруженную. Для загрузки фабрики используется метод -C<require()> с указанием элемента управления. - -=head2 Порядок обработки документа - -Построение представления данных состоит из двух этапов - -=over - -=item 1 Создание объектной модели документа. На данном этапе создаются все элементы управления. - -=item 1 Преобразование объектной модели в конечнное представление. На данном этапе происходит -форматирование документа. - -=back - - -=head2 Загрузка элемента управления - -=over - -=item 1 C<TInput = require('my/org/input')> - -=item 1 Загружается шаблон C<my/org/input.tt> - -=item 1 Создается фабрика элементов управления с собственным контекстом, унаследованным от контекст документа. - -=item 1 При первом создании элемента управления фабрика инициализируется выполнением блока C<INIT>. - -=back - -=head2 Создание элемента управления - -=over - -=item 1 C<< TInput.new('login') >> - -=item 1 Создается новый дочерний контекст к контексту фабрики - -=item 1 Создается экземпляр элемента управления - -=item 1 Выполняется блок конструктора C<CTOR> в контексте элемента управления, параметр C<this> имеет значение -нового экземпляра элемента управления - -=back - -=head1 MEMBERS =over -=item C<CTOR($template, $contextOpts, $loader[, $vars])> - -Создает экземпляр документа с указанным шаблоном и параметрами. - -=over - -=item C<$template> - -C<Template::Document> шаблон документа. - -=item C<$contextOpts> - -C<HASH> Параметры контекста C<Template::Context> для документа. Эти параметры будут сохранены -в свойстве C<opts>, а также на их основе будет создан контекст текщего документа. Как правило -эти параметы задаются загрузчиком документа C<IMPL::Web::View::TTLoader>, таким образом, что -C<Template::Stash> создаваемого контекста наследует переменные из контекста загрузчика. - -=item C<$loader> - -C<IMPL::Web::View::TTLoader> загрузчик, который будет использоваться для загрузки элементов управления, -а также для получения обертки, заданной в свойстве документа C<layout>. - -=item C<$vars> - -C<HASH> Необязательный параметр. переменные которые будут переданы в блок конструктора C<INIT>. -Как правило они используются для передачи данных для построения документа - -=back - -=back - -=over - -=item C<templateVars($name[,$newValue])> - -Получает или задает переменную для шаблона документа. Имя переменнной может быть составным, -например C<'my.var.name'>, см. C<Template::Stash::set()>. - -=item C<RequireControl($controlName)> - -Загружает фабрику элемента управления, если она уже была загружена, возвращает на нее ссылку. -При загрузки фабрики для нее создается собственный контекст на основе параметров из свойства -C<opts> и ее пространство имен наследуется от пространства имен документа из свойства C<stash>. - -=item C<Render($vars)> - -Выполняет блок C<renderBlock> документа для получения конечного представления, C<$vars> -содержит переменные для блока. - -=item C<RenderContent($vars)> - -Выполняет шаблон документа для получения представления содержимого, в отличии от -метода C<Render> не использует обертку указанную в свойстве C<layout>, если обертка -не указана, то эти методы идентичны. - -=item C<[get,set]layout> - -Обертка, которая будет использована для построения представления документа. В обертке -будет доступна специальная переменная C<content>, при обращении к которой будет B<выполнен> -метод C<RenderContent()> и возвращен результат его работы. Для получения шаблона обертки -используется загрузчик из свойства C<loader>. - -=item C<[get]opts> - -Параметры контекста, используются для создания контекстов фабрик элементов управления. - -=item C<[get]loader> - -Загрузчик, используется для загрузки шаблонов фабрик элементов управления и обертки. - -=item C<[get]controls> - -C<HASH> Коллекция загруженных фабрик элементов управления, ключем является -квалифицированное имя элемента управления. - -=item C<[get]stash> - -C<Template::Stash> Пространство имен документа, оно используется как родительское -для пространств имен загружаемых фабрик элементов управления. - -=back - -=head1 TEMPLATES - -=begin text - -[%META layout='default'%] -[% BLOCK CTOR; - section('top','TOP'); - section('bottom','BOTTOM'); - section('client','CLIENT'); -END %] -[% BLOCK TOP; - TMenu = require('my/org/Menu'); - append(TMenu.new()); -END %] - -=end =cut \ No newline at end of file