| 包 | system.web.widgets |
|---|---|
| 继承 | class CContentDecorator » COutputProcessor » CFilterWidget » CWidget » CBaseController » CComponent |
| 实现 | IFilter |
| 源自 | 1.0 |
| 版本 | $Id: CContentDecorator.php 3515 2011-12-28 12:29:24Z mdomba $ |
| 源码 |
CContentDecorator 装饰放置在指定的view中的内容。
CContentDecorator 通常用于实现嵌套布局，也就是说，一个布局 嵌入到另一个布局之中。CBaseController 定义了一对方 便的方法以使用CContentDecorator：
属性view指定了将用于装饰内容的视图的名字。 在视图中，被装饰的内容可以通过变量
CContentDecorator 通常用于实现嵌套布局，也就是说，一个布局 嵌入到另一个布局之中。CBaseController 定义了一对方 便的方法以使用CContentDecorator：
$this->beginContent('path/to/view');
// ... 需要被装饰的内容
$this->endContent();
属性view指定了将用于装饰内容的视图的名字。 在视图中，被装饰的内容可以通过变量
$content
进行访问。公共属性
| 属性 | 类型 | 描述 | 定义在 |
|---|---|---|---|
| actionPrefix | string | actions的ID的前缀。 当微件在CController::actions中声明了 动作提供者，可以为其动作的ID指定前缀以区别 于别的微件或控制器。当微件用于控制器 的视图中时，必须配置同样的前缀。 | CWidget |
| controller | CController | 返回此微件所属的控制器。 | CWidget |
| data | array | 被提取出来使之可以在装饰的视图中使用的变量集 (name=>value)。 | CContentDecorator |
| id | string | 返回此微件的ID。如果需要的话，将生产一个新的ID并将其返回。 | CWidget |
| isFilter | boolean | 这个widget是否作为一个过滤器使用。 | CFilterWidget |
| owner | CBaseController | 返回此微件的所有者或创建者。 | CWidget |
| skin | mixed | 微件使用的皮肤的名称。默认为“default”。 如果此属性设置为false，微件将不会有皮肤被使用。 | CWidget |
| stopAction | boolean | 当这个widget用作一个过滤器时是否停止动作的执行。 此属性应当仅在CWidget::init方法中进行改变。 默认值是false，表示动作将会被执行。 | CFilterWidget |
| view | mixed | 用于装饰被捕获的内容的视图的名字。 如果此属性值为null（默认值），那么默认的布局视图将被使用。 注意：如果当前控制器不属于任何模块，默认布局指应用的 default layout； 如果当前控制器属于一个模块，默认布局指所属模块的 default layout。 | CContentDecorator |
| viewPath | string | 返回包含此微件所需的视图文件的路径。 | CWidget |
公共方法
受保护方法
| 方法 | 描述 | 定义在 |
|---|---|---|
| decorate() | 通过渲染一个视图，并将内容嵌入其中来装饰内容。 | CContentDecorator |
事件
| 事件 | 描述 | 定义在 |
|---|---|---|
| onProcessOutput | 当获取到输出时激发。 | COutputProcessor |
属性详细
data
属性
public array $data;
被提取出来使之可以在装饰的视图中使用的变量集 (name=>value)。
view
属性
public mixed $view;
用于装饰被捕获的内容的视图的名字。 如果此属性值为null（默认值），那么默认的布局视图将被使用。 注意：如果当前控制器不属于任何模块，默认布局指应用的 default layout； 如果当前控制器属于一个模块，默认布局指所属模块的 default layout。
方法详细
decorate()
方法
|
protected string decorate(string $content)
| ||
| $content | string | 需要被装饰的内容 |
| {return} | string | 已装饰过的内容 |
protected function decorate($content)
{
$owner=$this->getOwner();
if($this->view===null)
$viewFile=Yii::app()->getController()->getLayoutFile(null);
else
$viewFile=$owner->getViewFile($this->view);
if($viewFile!==false)
{
$data=$this->data;
$data['content']=$content;
return $owner->renderFile($viewFile,$data,true);
}
else
return $content;
}
通过渲染一个视图，并将内容嵌入其中来装饰内容。
嵌入的内容可以在视图中通过变量$content进行访问。
被装饰的内容将直接显示出来。
processOutput()
方法
|
public void processOutput(string $output)
| ||
| $output | string | 需要被处理的捕获到的输出。 |
public function processOutput($output)
{
$output=$this->decorate($output);
parent::processOutput($output);
}
处理已捕获的输出。 此方法使用指定的view来装饰输出。