annotate Lib/IMPL/Web/View/TTDocument.pm @ 198:2ffe6f661605

Implemented IMPL::Web::Handler::RestController fixes in IMPL::Serialization completed IMPL::Web::Application::RestResource added IMPL::Web::Handler::JSONView added IMPL::Web::RestContract
author cin
date Fri, 20 Apr 2012 16:06:36 +0400
parents 7a920771fd8e
children 292226770180
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
1 package IMPL::Web::View::TTDocument;
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
2 use strict;
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
3
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
4 use IMPL::lang qw(:declare :constants);
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
5 use IMPL::DOM::Property qw(_dom);
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
6 use IMPL::Web::View::TTFactory();
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
7 use IMPL::Web::View::TTControl();
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
8
190
cd1ff7029a63 IMLP::Web::View refactored, added new method 'require' which is available inside templates. Changed document rendering.
cin
parents: 189
diff changeset
9 use Scalar::Util qw(weaken);
cd1ff7029a63 IMLP::Web::View refactored, added new method 'require' which is available inside templates. Changed document rendering.
cin
parents: 189
diff changeset
10
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
11
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
12 use parent qw(
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
13 IMPL::DOM::Document
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
14 IMPL::Web::View::TTControl
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
15 );
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
16
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
17 BEGIN {
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
18 public _dom property layout => PROP_ALL;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
19 public property opts => PROP_GET | PROP_OWNERSET;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
20 public property loader => PROP_ALL;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
21 public property controls => PROP_GET | PROP_OWNERSET;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
22
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
23 # store the stash separately to make require() method to work correctly
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
24 # even when a stash of the context is modified during the processing
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
25 public property stash => PROP_GET | PROP_OWNERSET;
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
26 }
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
27
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
28 sub CTOR {
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
29 my ($this,$template,$refOpts,$loader,$vars) = @_;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
30
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
31 $this->controls({});
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
32 $this->loader($loader) if $loader;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
33
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
34 $this->layout( $template->layout ) unless $this->layout;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
35
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
36 $this->opts($refOpts);
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
37 $this->stash($this->context->stash);
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
38
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
39 my $self = $this;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
40 weaken($self);
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
41
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
42 $this->templateVars('require', sub {
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
43 my $doc = $self;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
44 die new IMPL::Exception("A document is destroyed or invalid") unless $doc;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
45 $doc->require(@_);
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
46 });
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
47
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
48 $this->templateVars('document', sub { $self } );
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
49 $this->InitInstance($vars);
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
50 }
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
51
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
52 our %CTOR = (
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
53 'IMPL::Web::View::TTControl' => sub {
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
54 my ($template,$contextOpts) = @_;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
55 'document',
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
56 $_[0], # template
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
57 new Template::Context($_[1]) # context
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
58 },
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
59 'IMPL::DOM::Document' => sub {
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
60 nodeName => 'document'
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
61 }
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
62 );
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
63
189
08015e2803f1 IMPL::Vew::Web - fixed memory leaks, more tests
cin
parents: 188
diff changeset
64 sub templateVars {
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
65 my $this = shift;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
66 my $name = shift;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
67
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
68 if (@_) {
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
69 return $this->stash->set($name, shift);
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
70 } else {
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
71 return $this->stash->get($name);
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
72 }
189
08015e2803f1 IMPL::Vew::Web - fixed memory leaks, more tests
cin
parents: 188
diff changeset
73 }
08015e2803f1 IMPL::Vew::Web - fixed memory leaks, more tests
cin
parents: 188
diff changeset
74
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
75 sub require {
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
76 my ($this, $control, $nodeProps) = @_;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
77
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
78 $nodeProps ||= {};
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
79 $nodeProps->{document} = $this;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
80
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
81 if (my $factory = $this->controls->{$control}) {
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
82 return $factory;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
83 } else {
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
84
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
85 my $path = $control;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
86 if ( my $template = $this->loader->template($path) ) {
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
87 my $opts = { %{$this->opts} };
189
08015e2803f1 IMPL::Vew::Web - fixed memory leaks, more tests
cin
parents: 188
diff changeset
88
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
89 # avoid propagation of local variables
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
90 $opts->{STASH} = $this->stash->clone();
188
029c9610528c Memory leak tests in IMPL::Web::View
cin
parents: 187
diff changeset
91
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
92 my $ctx = new Template::Context($opts);
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
93
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
94 $factory = new IMPL::Web::View::TTFactory(
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
95 $template->class || typeof IMPL::Web::View::TTControl,
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
96 $template,
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
97 $ctx,
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
98 $opts
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
99 );
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
100
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
101 my @parts = split(/\/+/,$control);
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
102
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
103 $this->controls->{$control} = $factory;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
104
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
105 return $factory;
188
029c9610528c Memory leak tests in IMPL::Web::View
cin
parents: 187
diff changeset
106
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
107 } else {
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
108 die new IMPL::KeyNotFoundException($control);
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
109 }
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
110 }
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
111 }
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
112
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
113 sub Render {
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
114 my ($this,$args) = @_;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
115
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
116 my $output;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
117
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
118 if ($this->layout) {
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
119 $output = $this->context->include(
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
120 $this->loader->layout($this->layout),
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
121 {
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
122 content => sub { $output ||= $this->RenderContent($args); },
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
123 this => $this,
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
124 template => $this->template
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
125 }
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
126 );
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
127 } else {
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
128 return $this->RenderContent($args);
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
129 }
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
130
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
131 return $output;
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
132 }
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
133
190
cd1ff7029a63 IMLP::Web::View refactored, added new method 'require' which is available inside templates. Changed document rendering.
cin
parents: 189
diff changeset
134 sub RenderContent {
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
135 my $this = shift;
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
136 return $this->SUPER::Render(@_);
190
cd1ff7029a63 IMLP::Web::View refactored, added new method 'require' which is available inside templates. Changed document rendering.
cin
parents: 189
diff changeset
137 }
cd1ff7029a63 IMLP::Web::View refactored, added new method 'require' which is available inside templates. Changed document rendering.
cin
parents: 189
diff changeset
138
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
139
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
140 1;
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
141
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
142 __END__
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
143
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
144 =pod
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
145
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
146 =head1 NAME
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
147
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
148 C<IMPL::Web::View::TTDocument> - документ для построения HTML страницы на основе шаблонов TT.
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
149
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
150 =head1 SYNOPSIS
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
151
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
152 =begin code
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
153
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
154 use IMPL::Web::View::TTDocument();
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
155
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
156 my $doc = new IMPL::Wbe::View::TTDocument($template,$ttOptions);
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
157
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
158 return $doc->Render();
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
159
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
160 =end code
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
161
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
162 Однако, более предпочтительный способ использовать C<IMPL::Web::View::TTLoader>.
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
163
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
164 =head1 DESCRIPTION
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
165
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
166 Документ для представления данных. Документы представляют собой иерархически организованные данные,
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
167 элементами данного документа являются данные для отображения, такие как
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
168
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
169 =over
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
170
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
171 =item * Объекты из БД
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
172
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
173 =item * Навигационные цепочки
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
174
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
175 =item * Меню и т.п.
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
176
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
177 =back
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
178
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
179 Скприт шаблона формирует структуру документа, затем сформированная структура форматируется в готовый документ.
192
a9faf883cdce IMPL::Web::View refactoring
cin
parents: 191
diff changeset
180 Процесс форматирования объектной модели в готовый документ может быть выполнена как вручную, так и при помощи
189
08015e2803f1 IMPL::Vew::Web - fixed memory leaks, more tests
cin
parents: 188
diff changeset
181 вспомогательного шаблона - обертки. Если у шаблона документа указан C<layout> в метаданных, то он будет
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
182 использован как шаблон для форматирования объектной модели, вывод самого шаблона будет проигнорирован. Если
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
183 обертка не задана, то результатом будет вывод самого скрипта шаблона.
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
184
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
185 Использование объектной модели документа позволяет решить задачи по созданию контейнеров,
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
186 у которых может быть сложное содежимое. Примером таких элементов могут быть формы,
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
187 внутри форм элементы управления также могут группироваться.
192
a9faf883cdce IMPL::Web::View refactoring
cin
parents: 191
diff changeset
188
193
sergey
parents: 192
diff changeset
189 =head2 Элементы управления (компоненты)
sergey
parents: 192
diff changeset
190
sergey
parents: 192
diff changeset
191 Документ состоит из узлов, часть которых наследуется от C<IMPL::Web::View::TTControl>, такие узлы называются
sergey
parents: 192
diff changeset
192 элементами управления. Каждый элемент управления имеет собственный контекст, который наследуется от контекста
sergey
parents: 192
diff changeset
193 документа.
sergey
parents: 192
diff changeset
194
sergey
parents: 192
diff changeset
195 =head2 Фабрика элементов управления
sergey
parents: 192
diff changeset
196
sergey
parents: 192
diff changeset
197 Для создания элементов управления используются фабрики. Каждый элемен управления имеет свой шаблон для
sergey
parents: 192
diff changeset
198 форматиорвания содержимого, фабрика связывает шаблон и класс элемента управления, для чего при загрузке
sergey
parents: 192
diff changeset
199 шаблона используется свойство C<type> из метаданных. Фабрика загружается в документ при том только один
sergey
parents: 192
diff changeset
200 раз, повторные загрузки фабрики возвращают уже загруженную. Для загрузки фабрики используется метод
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
201 C<require()> с указанием элемента управления.
190
cd1ff7029a63 IMLP::Web::View refactored, added new method 'require' which is available inside templates. Changed document rendering.
cin
parents: 189
diff changeset
202
185
ae8072f2f2a3 IMPL::Web::View::TTDocument tests, fixes
cin
parents: 181
diff changeset
203 =head2 Порядок обработки документа
ae8072f2f2a3 IMPL::Web::View::TTDocument tests, fixes
cin
parents: 181
diff changeset
204
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
205 Построение представления данных состоит из двух этапов
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
206
185
ae8072f2f2a3 IMPL::Web::View::TTDocument tests, fixes
cin
parents: 181
diff changeset
207 =over
ae8072f2f2a3 IMPL::Web::View::TTDocument tests, fixes
cin
parents: 181
diff changeset
208
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
209 =item 1 Создание объектной модели документа. На данном этапе создаются все элементы управления.
185
ae8072f2f2a3 IMPL::Web::View::TTDocument tests, fixes
cin
parents: 181
diff changeset
210
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
211 =item 1 Преобразование объектной модели в конечнное представление. На данном этапе происходит
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
212 форматирование документа.
185
ae8072f2f2a3 IMPL::Web::View::TTDocument tests, fixes
cin
parents: 181
diff changeset
213
ae8072f2f2a3 IMPL::Web::View::TTDocument tests, fixes
cin
parents: 181
diff changeset
214 =back
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
215
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
216
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
217 =head2 Загрузка элемента управления
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
218
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
219 =over
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
220
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
221 =item 1 C<TInput = require('my/org/input')>
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
222
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
223 =item 1 Загружается шаблон C<my/org/input.tt>
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
224
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
225 =item 1 Создается фабрика элементов управления с собственным контекстом, унаследованным от контекст документа.
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
226
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
227 =item 1 При первом создании элемента управления фабрика инициализируется выполнением блока C<INIT>.
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
228
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
229 =back
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
230
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
231 =head2 Создание элемента управления
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
232
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
233 =over
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
234
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 193
diff changeset
235 =item 1 C<< TInput.new('login') >>
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
236
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
237 =item 1 Создается новый дочерний контекст к контексту фабрики
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
238
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
239 =item 1 Создается экземпляр элемента управления
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
240
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
241 =item 1 Выполняется блок конструктора C<CTOR> в контексте элемента управления, параметр C<this> имеет значение
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
242 нового экземпляра элемента управления
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
243
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
244 =back
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
245
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
246 =head1 MEMBERS
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
247
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
248 =over
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
249
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
250 =item C<CTOR($template, $contextOpts, $loader[, $vars])>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
251
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
252 Создает экземпляр документа с указанным шаблоном и параметрами.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
253
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
254 =over
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
255
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
256 =item C<$template>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
257
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
258 C<Template::Document> шаблон документа.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
259
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
260 =item C<$contextOpts>
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
261
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
262 C<HASH> Параметры контекста C<Template::Context> для документа. Эти параметры будут сохранены
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
263 в свойстве C<opts>, а также на их основе будет создан контекст текщего документа. Как правило
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
264 эти параметы задаются загрузчиком документа C<IMPL::Web::View::TTLoader>, таким образом, что
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
265 C<Template::Stash> создаваемого контекста наследует переменные из контекста загрузчика.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
266
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
267 =item C<$loader>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
268
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
269 C<IMPL::Web::View::TTLoader> загрузчик, который будет использоваться для загрузки элементов управления,
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
270 а также для получения обертки, заданной в свойстве документа C<layout>.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
271
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
272 =item C<$vars>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
273
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
274 C<HASH> Необязательный параметр. переменные которые будут переданы в блок конструктора C<INIT>.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
275 Как правило они используются для передачи данных для построения документа
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
276
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
277 =back
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
278
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
279 =back
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
280
195
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
281 =over
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
282
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
283 =item C<templateVars($name[,$newValue])>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
284
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
285 Получает или задает переменную для шаблона документа. Имя переменнной может быть составным,
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
286 например C<'my.var.name'>, см. C<Template::Stash::set()>.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
287
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
288 =item C<require($controlName)>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
289
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
290 Загружает фабрику элемента управления, если она уже была загружена, возвращает на нее ссылку.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
291 При загрузки фабрики для нее создается собственный контекст на основе параметров из свойства
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
292 C<opts> и ее пространство имен наследуется от пространства имен документа из свойства C<stash>.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
293
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
294 =item C<Render($vars)>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
295
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
296 Выполняет блок C<renderBlock> документа для получения конечного представления, C<$vars>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
297 содержит переменные для блока.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
298
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
299 =item C<RenderContent($vars)>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
300
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
301 Выполняет шаблон документа для получения представления содержимого, в отличии от
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
302 метода C<Render> не использует обертку указанную в свойстве C<layout>, если обертка
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
303 не указана, то эти методы идентичны.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
304
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
305 =item C<[get,set]layout>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
306
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
307 Обертка, которая будет использована для построения представления документа. В обертке
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
308 будет доступна специальная переменная C<content>, при обращении к которой будет B<выполнен>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
309 метод C<RenderContent()> и возвращен результат его работы. Для получения шаблона обертки
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
310 используется загрузчик из свойства C<loader>.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
311
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
312 =item C<[get]opts>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
313
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
314 Параметры контекста, используются для создания контекстов фабрик элементов управления.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
315
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
316 =item C<[get]loader>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
317
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
318 Загрузчик, используется для загрузки шаблонов фабрик элементов управления и обертки.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
319
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
320 =item C<[get]controls>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
321
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
322 C<HASH> Коллекция загруженных фабрик элементов управления, ключем является
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
323 квалифицированное имя элемента управления.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
324
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
325 =item C<[get]stash>
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
326
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
327 C<Template::Stash> Пространство имен документа, оно используется как родительское
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
328 для пространств имен загружаемых фабрик элементов управления.
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
329
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
330 =back
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
331
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
332 =head1 TEMPLATES
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
333
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
334 =begin text
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
335
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
336 [%META layout='default'%]
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
337 [% BLOCK CTOR;
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
338 section('top','TOP');
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
339 section('bottom','BOTTOM');
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
340 section('client','CLIENT');
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
341 END %]
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
342 [% BLOCK TOP;
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
343 TMenu = require('my/org/Menu');
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
344 append(TMenu.new());
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
345 END %]
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
346
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
347 =end
7a920771fd8e IMPL::Web::View changed document layout handling, docs, examples
cin
parents: 194
diff changeset
348
181
47dac58691ee New templating system, small fixes
sourcer
parents:
diff changeset
349 =cut