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