在进行页面输出渲染的时候。
1.render 输出父模板的内容,将渲染的内容,嵌入父模板。|
2.renderPartial 则不输出父模板的内容。只对本次渲染的局部内容,进行输出。
同时还有个重要的区别:
render 函数内部默认执行processOutput($output)函数, 会将把组件,比如 CTreeView 里面注册到 CClientScript 里面的
需要的脚本进行渲染输出。
而renderPartial() 默认不自动渲染输出客户端脚本,需要进行参数的指定,才会输出:
renderPartial($view,$data=null,$return=false,$processOutput=false)
指定processOutput 为 true 即可。
比如要局部输出 CTreeView ,用renderPartial 进行渲染,如果按照默认processOutput=false 则输出内容,不含有客户端脚本
输出内容则为 正常的 ul 列表。没有树形的折叠效果。 主动设定 processOutput=true 后,CTreeView 所需的,所有客户端脚本就会被正常输出在列表的前面。
下面介绍下要用到的几个相关的函数:
render,renderPartial 不再介绍
processOutput()
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
|
<?php
publicfunction render(
$view
,
$data
=null,
$return
=false)
{
if
(
$this
->beforeRender(
$view
))
{
$output
=
$this
->renderPartial(
$view
,
$data
,true);
if
((
$layoutFile
=
$this
->getLayoutFile(
$this
->layout))!==false)
$output
=
$this
->renderFile(
$layoutFile
,
array
(
'content'
=>
$output
),true);
$this
->afterRender(
$view
,
$output
);
$output
=
$this
->processOutput(
$output
);
if
(
$return
)
return
$output
;
else
echo
$output
;
}
}
publicfunction renderPartial(
$view
,
$data
=null,
$return
=false,
$processOutput
=false)
{
if
((
$viewFile
=
$this
->getViewFile(
$view
))!==false)
{
$output
=
$this
->renderFile(
$viewFile
,
$data
,true);
if
(
$processOutput
)
$output
=
$this
->processOutput(
$output
);
if
(
$return
)
return
$output
;
else
echo
$output
;
}
else
thrownewCException(Yii::t(
'yii'
,
'{controller} cannot find the requested view "{view}".'
,
array
(
'{controller}'
=>get_class(
$this
),
'{view}'
=>
$view
)));
}
publicfunction processOutput(
$output
)
{
Yii::app()->getClientScript()->render(
$output
);
// if using page caching, we should delay dynamic output replacement
if
(
$this
->_dynamicOutput!==null&&
$this
->isCachingStackEmpty())
{
$output
=
$this
->processDynamicOutput(
$output
);
$this
->_dynamicOutput=null;
}
if
(
$this
->_pageStates===null)
$this
->_pageStates=
$this
->loadPageStates();
if
(!
empty
(
$this
->_pageStates))
$this
->savePageStates(
$this
->_pageStates,
$output
);
return
$output
;
}
|