|
181
|
1 package IMPL::Web::View::TTControl;
|
|
|
2 use strict;
|
|
|
3
|
|
191
|
4 use Scalar::Util qw(weaken);
|
|
181
|
5
|
|
234
|
6 use IMPL::Const qw(:prop);
|
|
|
7 use IMPL::declare {
|
|
|
8 require => {
|
|
|
9 TTContext => 'Template::Context',
|
|
|
10 Exception => 'IMPL::Exception',
|
|
|
11 ArgumentException => '-IMPL::InvalidArgumentException'
|
|
|
12 },
|
|
|
13 base => [
|
|
|
14 'IMPL::DOM::Node' => sub {
|
|
|
15 nodeName => $_[0],
|
|
|
16 %{ $_[3] || {} }
|
|
|
17 }
|
|
|
18 ],
|
|
|
19 props => [
|
|
|
20 id => PROP_RO,
|
|
|
21 context => PROP_RO,
|
|
|
22 template => PROP_RO
|
|
|
23 ]
|
|
|
24 };
|
|
|
25
|
|
181
|
26
|
|
187
|
27 {
|
|
194
|
28 my $nextId = 1;
|
|
|
29 sub _GetNextId {
|
|
|
30 return $nextId++;
|
|
|
31 }
|
|
187
|
32 }
|
|
181
|
33
|
|
|
34 sub CTOR {
|
|
194
|
35 my ($this,$name,$template,$context,$refProps) = @_;
|
|
|
36
|
|
|
37 $name ||= "control";
|
|
|
38
|
|
|
39 $this->template( $template ) or die new IMPL::ArgumentException("A template is required");
|
|
|
40 $this->context( $context ) or die new IMPL::ArgumentException("A context is required");
|
|
|
41
|
|
|
42 $this->id($name . "-" . _GetNextId()) unless $this->id;
|
|
|
43
|
|
236
|
44 #TODO: deprecated, cleanup
|
|
|
45 #weaken($this); # prevent cyclic references produced by the code below
|
|
194
|
46
|
|
236
|
47 #$context->stash->set('append', sub { $this->appendChild(@_); undef; } );
|
|
|
48 #$context->stash->set('select', sub { $this->selectNodes(@_); } );
|
|
181
|
49 }
|
|
|
50
|
|
191
|
51 sub InitInstance {
|
|
194
|
52 my ($this,$args) = @_;
|
|
|
53
|
|
|
54 $args ||= {};
|
|
|
55
|
|
|
56 if ( my $ctor = $this->template->blocks->{CTOR} ) {
|
|
212
|
57 $this->context->include($ctor, { %$args, this => $this, template => $this->template } );
|
|
194
|
58 }
|
|
191
|
59 }
|
|
|
60
|
|
234
|
61 sub GetRenderBlock {
|
|
194
|
62 $_[0]->template->blocks->{RENDER} || $_[0]->template;
|
|
187
|
63 }
|
|
|
64
|
|
|
65 sub Render {
|
|
194
|
66 my ($this,$args) = @_;
|
|
|
67
|
|
|
68 $args = {} unless ref $args eq 'HASH';
|
|
|
69
|
|
234
|
70 if(my $body = $this->GetRenderBlock ) {
|
|
194
|
71 return $this->context->include( $body, { %$args, this => $this, template => $this->template, document => $this->document } );
|
|
|
72 } else {
|
|
|
73 return "";
|
|
|
74 }
|
|
185
|
75 }
|
|
|
76
|
|
|
77 sub AUTOLOAD {
|
|
194
|
78 our $AUTOLOAD;
|
|
|
79
|
|
|
80 my $method = ($AUTOLOAD =~ m/(\w+)$/)[0];
|
|
|
81
|
|
|
82 return if $method eq 'DESTROY';
|
|
|
83
|
|
|
84 my $this = shift;
|
|
212
|
85
|
|
194
|
86 $this->nodeProperty($method,@_);
|
|
181
|
87 }
|
|
|
88
|
|
|
89 1;
|
|
|
90
|
|
|
91 __END__
|
|
|
92
|
|
|
93 =pod
|
|
|
94
|
|
|
95 =head1 NAME
|
|
|
96
|
|
|
97 C<IMPL::Web::View::TTControl>
|
|
|
98
|
|
|
99 =head1 SYNPOSIS
|
|
|
100
|
|
|
101 =head1 DESCRIPTION
|
|
|
102
|
|
|
103 =head2 BLOCKS
|
|
|
104
|
|
|
105 =head3 INIT
|
|
|
106
|
|
213
|
107 Данный блок шаблона управления выполняется один раз при создании первого экземпляра элемента управления,
|
|
|
108 может использоваться для формирования заголовочной части документа, скрипта подключающего ajax модули
|
|
|
109 при необходимости и т.п.
|
|
181
|
110
|
|
|
111 =head3 CTOR
|
|
|
112
|
|
|
113 данный блок выполняется каждый раз при создании нового экземпляра элемента управления, при этом переменная C<this>
|
|
213
|
114 указывает на эземпляр элемента упарвления. Данный блок можно использовать для инициализации свойств элемента
|
|
|
115 управления.
|
|
181
|
116
|
|
|
117 =head3 RENDER
|
|
|
118
|
|
213
|
119 Данный блок выполняется при вызове метода C<Render()>, вывод данного блока и есть результат отображения элемента управления.
|
|
|
120 Если в шаблоне нет блока C<RENDER>, то сам шаблон считается таковым.
|
|
187
|
121
|
|
|
122 =head2 TEMPLATE VARS
|
|
|
123
|
|
|
124 Каждый шаблон имеет собственное пространство имен, унаследованное от пространства имен фабрики элементов (которая в свою очередь наследует контекст документа).
|
|
|
125 В шаблоне могут определяться новые переменные, которые разделяются между блоками. Также доступны стандартные переменные
|
|
|
126
|
|
|
127 =over
|
|
|
128
|
|
|
129 =item * C<this> ссылка на объект элемента управления
|
|
|
130
|
|
|
131 =item * C<component> ссылка на текущий шаблон, устанавливается автоматически в методе C<Template::Context::process>.
|
|
|
132
|
|
|
133 =item * C<template> ссылка на шаблон элемента управления, для совместимости с C<TT>
|
|
|
134
|
|
|
135 =back
|
|
|
136
|
|
|
137 =head1 MEMBERS
|
|
|
138
|
|
|
139 =over
|
|
|
140
|
|
|
141 =item * C<[get]context>
|
|
|
142
|
|
|
143 Контекст элемента управления, хранит пременные шаблона. Наследуется от контекста фабрики элементов управления, который
|
|
|
144 наследуется от контекста документа.
|
|
|
145
|
|
|
146 =item * C<[get,set]template>
|
|
|
147
|
|
|
148 C<Template::Document> Шаблон элемента управления.
|
|
|
149
|
|
|
150 =item * C<AUTOLOAD>
|
|
|
151
|
|
|
152 Для удобства работы с шаблоном, элементы управления предоставляю доступ к своим свойствам через метод C<AUTOLOAD>.
|
|
|
153
|
|
|
154 =back
|
|
181
|
155
|
|
|
156
|
|
|
157 C<lang ru>
|
|
|
158
|
|
|
159 =cut |
