blob: ad97d30d1baf24f8ad2f325d7099c49a981771b4 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
<?php
/**
* TActiveRepeater class file
*
* @author LANDWEHR Computer und Software GmbH <programmierung@landwehr-software.de>
* @package System.Web.UI.ActiveControls
* @since 3.1.9
*/
/**
* TActiveRepeater class
*
* TActiveRepeater represents a data bound and updatable grid control which is the
* active counterpart to the original {@link TRepeater} control.
*
* This component can be used in the same way as the regular datagrid, the only
* difference is that the active repeater uses callbacks instead of postbacks
* for interaction.
*
* Please refer to the original documentation of the regular counterparts for usage.
*
* @author LANDWEHR Computer und Software GmbH <programmierung@landwehr-software.de>
* @package System.Web.UI.ActiveControls
* @since 3.1.9
*/
class TActiveRepeater extends TRepeater implements IActiveControl, ISurroundable {
/**
* @var string the tag used to render the surrounding container
*/
protected $_surroundingTag='div';
/**
* Creates a new callback control, sets the adapter to
* TActiveControlAdapter.
*/
public function __construct() {
parent::__construct();
$this->setAdapter(new TActiveControlAdapter($this));
}
/**
* @return TBaseActiveControl standard active control options.
*/
public function getActiveControl() {
return $this->getAdapter()->getBaseActiveControl();
}
/**
* Sets the data source object associated with the repeater control.
* In addition, the render method of all connected pagers is called so they
* get updated when the data source is changed. Also the repeater registers
* itself for rendering in order to get it's content replaced on client side.
* @param Traversable|array|string data source object
*/
public function setDataSource($value) {
parent::setDataSource($value);
if($this->getActiveControl()->canUpdateClientSide()) {
$this->renderPager();
$this->getPage()->getAdapter()->registerControlToRender($this,$this->getResponse()->createHtmlWriter());
}
}
/**
* Gets the tag used to render the surrounding container. Defaults to 'div'.
* @return string container tag
*/
public function getSurroundingTag() {
return $this->_surroundingTag;
}
/**
* Sets the tag used to render the surrounding container.
* @param string $value container tag
*/
public function setSurroundingTag($value) {
$this->_surroundingTag=TPropertyValue::ensureString($value);
}
/**
* Returns the id of the surrounding container.
* @return string container id
*/
public function getSurroundingTagID() {
return $this->getClientID().'_Container';
}
/**
* Renders the repeater.
* If the repeater did not pass the prerender phase yet, it will register itself for rendering later.
* Else it will call the {@link renderRepeater()} method which will do the rendering of the repeater.
* @param THtmlWriter writer for the rendering purpose
*/
public function render($writer) {
if($this->getHasPreRendered()) {
$this->renderRepeater($writer);
if($this->getActiveControl()->canUpdateClientSide()) $this->getPage()->getCallbackClient()->replaceContent($this->getSurroundingTagId(),$writer);
}
else {
$this->getPage()->getAdapter()->registerControlToRender($this,$writer);
}
}
/**
* Loops through all {@link TActivePager} on the page and registers the ones which are set to paginate
* the repeater for rendering. This is to ensure that the connected pagers are also rendered if the
* data source changed.
*/
private function renderPager() {
$pager=$this->getPage()->findControlsByType('TActivePager', false);
foreach($pager as $item) {
if($item->ControlToPaginate==$this->ID) {
$writer=$this->getResponse()->createHtmlWriter();
$this->getPage()->getAdapter()->registerControlToRender($item,$writer);
}
}
}
/**
* Renders the repeater by writing a {@link getSurroundingTag()} with the container id obtained
* from {@link getSurroundingTagID()} which will be called by the replacement method of the client
* script to update it's content.
* @param THtmlWriter writer for the rendering purpose
*/
private function renderRepeater($writer) {
$writer->addAttribute('id',$this->getSurroundingTagID());
$writer->renderBeginTag($this->getSurroundingTag());
parent::render($writer);
$writer->renderEndTag();
}
}
|
