|
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
|
|
234
|
44 weaken($this); # prevent cyclic references produced by the code below
|
|
194
|
45
|
|
|
46 $context->stash->set('append', sub { $this->appendChild(@_); undef; } );
|
|
|
47 $context->stash->set('select', sub { $this->selectNodes(@_); } );
|
|
181
|
48 }
|
|
|
49
|
|
191
|
50 sub InitInstance {
|
|
194
|
51 my ($this,$args) = @_;
|
|
|
52
|
|
|
53 $args ||= {};
|
|
|
54
|
|
|
55 if ( my $ctor = $this->template->blocks->{CTOR} ) {
|
|
212
|
56 $this->context->include($ctor, { %$args, this => $this, template => $this->template } );
|
|
194
|
57 }
|
|
191
|
58 }
|
|
|
59
|
|
234
|
60 sub GetRenderBlock {
|
|
194
|
61 $_[0]->template->blocks->{RENDER} || $_[0]->template;
|
|
187
|
62 }
|
|
|
63
|
|
|
64 sub Render {
|
|
194
|
65 my ($this,$args) = @_;
|
|
|
66
|
|
|
67 $args = {} unless ref $args eq 'HASH';
|
|
|
68
|
|
234
|
69 if(my $body = $this->GetRenderBlock ) {
|
|
194
|
70 return $this->context->include( $body, { %$args, this => $this, template => $this->template, document => $this->document } );
|
|
|
71 } else {
|
|
|
72 return "";
|
|
|
73 }
|
|
185
|
74 }
|
|
|
75
|
|
|
76 sub AUTOLOAD {
|
|
194
|
77 our $AUTOLOAD;
|
|
|
78
|
|
|
79 my $method = ($AUTOLOAD =~ m/(\w+)$/)[0];
|
|
|
80
|
|
|
81 return if $method eq 'DESTROY';
|
|
|
82
|
|
|
83 my $this = shift;
|
|
212
|
84
|
|
194
|
85 $this->nodeProperty($method,@_);
|
|
181
|
86 }
|
|
|
87
|
|
|
88 1;
|
|
|
89
|
|
|
90 __END__
|
|
|
91
|
|
|
92 =pod
|
|
|
93
|
|
|
94 =head1 NAME
|
|
|
95
|
|
|
96 C<IMPL::Web::View::TTControl>
|
|
|
97
|
|
|
98 =head1 SYNPOSIS
|
|
|
99
|
|
|
100 =head1 DESCRIPTION
|
|
|
101
|
|
|
102 =head2 BLOCKS
|
|
|
103
|
|
|
104 =head3 INIT
|
|
|
105
|
|
213
|
106 Данный блок шаблона управления выполняется один раз при создании первого экземпляра элемента управления,
|
|
|
107 может использоваться для формирования заголовочной части документа, скрипта подключающего ajax модули
|
|
|
108 при необходимости и т.п.
|
|
181
|
109
|
|
|
110 =head3 CTOR
|
|
|
111
|
|
|
112 данный блок выполняется каждый раз при создании нового экземпляра элемента управления, при этом переменная C<this>
|
|
213
|
113 указывает на эземпляр элемента упарвления. Данный блок можно использовать для инициализации свойств элемента
|
|
|
114 управления.
|
|
181
|
115
|
|
|
116 =head3 RENDER
|
|
|
117
|
|
213
|
118 Данный блок выполняется при вызове метода C<Render()>, вывод данного блока и есть результат отображения элемента управления.
|
|
|
119 Если в шаблоне нет блока C<RENDER>, то сам шаблон считается таковым.
|
|
187
|
120
|
|
|
121 =head2 TEMPLATE VARS
|
|
|
122
|
|
|
123 Каждый шаблон имеет собственное пространство имен, унаследованное от пространства имен фабрики элементов (которая в свою очередь наследует контекст документа).
|
|
|
124 В шаблоне могут определяться новые переменные, которые разделяются между блоками. Также доступны стандартные переменные
|
|
|
125
|
|
|
126 =over
|
|
|
127
|
|
|
128 =item * C<this> ссылка на объект элемента управления
|
|
|
129
|
|
|
130 =item * C<component> ссылка на текущий шаблон, устанавливается автоматически в методе C<Template::Context::process>.
|
|
|
131
|
|
|
132 =item * C<template> ссылка на шаблон элемента управления, для совместимости с C<TT>
|
|
|
133
|
|
|
134 =back
|
|
|
135
|
|
|
136 =head1 MEMBERS
|
|
|
137
|
|
|
138 =over
|
|
|
139
|
|
|
140 =item * C<[get]context>
|
|
|
141
|
|
|
142 Контекст элемента управления, хранит пременные шаблона. Наследуется от контекста фабрики элементов управления, который
|
|
|
143 наследуется от контекста документа.
|
|
|
144
|
|
|
145 =item * C<[get,set]template>
|
|
|
146
|
|
|
147 C<Template::Document> Шаблон элемента управления.
|
|
|
148
|
|
|
149 =item * C<AUTOLOAD>
|
|
|
150
|
|
|
151 Для удобства работы с шаблоном, элементы управления предоставляю доступ к своим свойствам через метод C<AUTOLOAD>.
|
|
|
152
|
|
|
153 =back
|
|
181
|
154
|
|
|
155
|
|
|
156 C<lang ru>
|
|
|
157
|
|
|
158 =cut |
