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
|
<?php
/**
* TActivePanel file.
*
* @author Wei Zhuo <weizhuo[at]gamil[dot]com>
* @link http://www.pradosoft.com/
* @copyright Copyright © 2005-2014 PradoSoft
* @license http://www.pradosoft.com/license/
* @package Prado\Web\UI\ActiveControls
*/
namespace Prado\Web\UI\ActiveControls;
/**
* Load active control adapter.
*/
use Prado\Prado;
use Prado\Web\UI\WebControls\TPanel;
/**
* TActivePanel is the TPanel active control counterpart.
*
* TActivePanel allows the client-side panel contents to be updated during a
* callback response using the {@link render} method.
*
* Example: Assume $param is an instance of TCallbackEventParameter attached to
* the OnCallback event of a TCallback with ID "callback1", and
* "panel1" is the ID of a TActivePanel.
* <code>
* function callback1_requested($sender, $param)
* {
* $this->panel1->render($param->getNewWriter());
* }
* </code>
*
* @author Wei Zhuo <weizhuo[at]gmail[dot]com>
* @package Prado\Web\UI\ActiveControls
* @since 3.1
*/
class TActivePanel extends TPanel implements IActiveControl
{
/**
* Creates a new callback control, sets the adapter to
* TActiveControlAdapter. If you override this class, be sure to set the
* adapter appropriately by, for example, by calling this constructor.
*/
public function __construct()
{
parent::__construct();
$this->setAdapter(new TActiveControlAdapter($this));
}
/**
* @return TBaseActiveControl standard active control options.
*/
public function getActiveControl()
{
return $this->getAdapter()->getBaseActiveControl();
}
/**
* Adds attribute id to the renderer.
* @param THtmlWriter the writer used for the rendering purpose
*/
protected function addAttributesToRender($writer) {
$writer->addAttribute('id',$this->getClientID());
parent::addAttributesToRender($writer);
}
/**
* Renders and replaces the panel's content on the client-side.
* When render() is called before the OnPreRender event, such as when render()
* is called during a callback event handler, the rendering
* is defered until OnPreRender event is raised.
* @param THtmlWriter html writer
*/
public function render($writer)
{
if($this->getHasPreRendered())
{
parent::render($writer);
if($this->getActiveControl()->canUpdateClientSide())
$this->getPage()->getCallbackClient()->replaceContent($this,$writer);
}
else
{
$this->getPage()->getAdapter()->registerControlToRender($this,$writer);
if ($this->getHasControls())
{
// If we update a TActivePanel on callback,
// We shouldn't update all childs, because the whole content will be replaced by
// the parent
foreach ($this->findControlsByType('IActiveControl', false) as $control)
{
$control->getActiveControl()->setEnableUpdate(false);
}
}
}
}
}
|
