| 包 | zii.widgets.jui |
|---|---|
| 继承 | class CJuiAccordion » CJuiWidget » CWidget » CBaseController » CComponent |
| 源自 | 1.1 |
| 版本 | $Id: CJuiAccordion.php 2799 2011-01-01 19:31:13Z qiang.xue $ |
| 源码 |
CJuiAccordion显示一个可以折叠的部件。
CJuiAccordion封装了JUI Accordion 插件。
使用这个部件，你可以在视图里面插入以下代码：
通过配置options属性， 你可以指定需要传递给JUI accordion插件的选项。 如果需要选择（name-value pairs）， 请参阅JUI Accordion说明。
CJuiAccordion封装了JUI Accordion 插件。
使用这个部件，你可以在视图里面插入以下代码：
$this->widget('zii.widgets.jui.CJuiAccordion', array(
'panels'=>array(
'panel 1'=>'content for panel 1',
'panel 2'=>'content for panel 2',
// panel 3 contains the content rendered by a partial view
'panel 3'=>$this->renderPartial('_partial',null,true),
),
// additional javascript options for the accordion plugin
'options'=>array(
'animated'=>'bounceslide',
),
));
通过配置options属性， 你可以指定需要传递给JUI accordion插件的选项。 如果需要选择（name-value pairs）， 请参阅JUI Accordion说明。
公共属性
| 属性 | 类型 | 描述 | 定义在 |
|---|---|---|---|
| actionPrefix | string | actions的ID的前缀。 当微件在CController::actions中声明了 动作提供者，可以为其动作的ID指定前缀以区别 于别的微件或控制器。当微件用于控制器 的视图中时，必须配置同样的前缀。 | CWidget |
| contentTemplate | string | 这个模板习惯于生成每一个面板内容。 模板里的“{content}”标记会被面板的内容取代。 | CJuiAccordion |
| controller | CController | 返回此微件所属的控制器。 | CWidget |
| cssFile | mixed | 主题的CSS文件名。默认是‘jquery-ui. | CJuiWidget |
| headerTemplate | string | 这个模板习惯于生成每一个面板的头部。 模板里的“{title}”标志会被面板的标题所取代。 请注意，如对此面板做任何改变， 你也需要在options相应的调整‘header’。 | CJuiAccordion |
| htmlOptions | array | JUI组件中HTML标签的属性设置。 | CJuiWidget |
| id | string | 返回此微件的ID。如果需要的话，将生产一个新的ID并将其返回。 | CWidget |
| options | array | the 初始的JavaScript需要传递给JUI插件的选项。 | CJuiWidget |
| owner | CBaseController | 返回此微件的所有者或创建者。 | CWidget |
| panels | array | 列表面板（panel title=>panel content）。 请注意，没有任何面板的标题或者面板的内容被HTML-encoded。 | CJuiAccordion |
| scriptFile | mixed | 主要JUI的JavaScript的文件名。默认是‘jquery-ui. | CJuiWidget |
| scriptUrl | string | 包含所有JUI JavaScript文件的根目录。 如果没有设置这个属性（默认），Yii will publish the JUI package included in the zii release and use that to infer the root script URL. | CJuiWidget |
| skin | mixed | 微件使用的皮肤的名称。默认为“default”。 如果此属性设置为false，微件将不会有皮肤被使用。 | CWidget |
| tagName | string | 容器元素的名称，它包含所有的面板。默认为‘div’。 | CJuiAccordion |
| theme | string | JUI主题的名字。默认是‘base’。确保在themeUrl下有这样一个目录， 其名称是这个属性的值相同（区分大小写）。 | CJuiWidget |
| themeUrl | string | 包含所有JUI的主题文件夹的根目录。 如果没有设置这个属性（默认）， Yii will publish the JUI package included in the zii release and use that to infer the root theme URL. | CJuiWidget |
| viewPath | string | 返回包含此微件所需的视图文件的路径。 | CWidget |
公共方法
受保护方法
| 方法 | 描述 | 定义在 |
|---|---|---|
| registerCoreScripts() | 注册核心的脚本文件。 | CJuiWidget |
| registerScriptFile() | 注册一个JavaScript文件在scriptUrl下。 | CJuiWidget |
| resolvePackagePath() | 确定JUI包安装路径。 | CJuiWidget |
属性详细
contentTemplate
属性
public string $contentTemplate;
这个模板习惯于生成每一个面板内容。 模板里的“{content}”标记会被面板的内容取代。
headerTemplate
属性
public string $headerTemplate;
这个模板习惯于生成每一个面板的头部。 模板里的“{title}”标志会被面板的标题所取代。 请注意，如对此面板做任何改变， 你也需要在options相应的调整‘header’。
panels
属性
public array $panels;
列表面板（panel title=>panel content）。 请注意，没有任何面板的标题或者面板的内容被HTML-encoded。
tagName
属性
public string $tagName;
容器元素的名称，它包含所有的面板。默认为‘div’。
方法详细
run()
方法
|
public void run()
|
public function run()
{
$id=$this->getId();
if (isset($this->htmlOptions['id']))
$id = $this->htmlOptions['id'];
else
$this->htmlOptions['id']=$id;
echo CHtml::openTag($this->tagName,$this->htmlOptions)."\n";
foreach($this->panels as $title=>$content)
{
echo strtr($this->headerTemplate,array('{title}'=>$title))."\n";
echo strtr($this->contentTemplate,array('{content}'=>$content))."\n";
}
echo CHtml::closeTag($this->tagName);
$options=empty($this->options) ? '' : CJavaScript::encode($this->options);
Yii::app()->getClientScript()->registerScript(__CLASS__.'#'.$id,"jQuery('#{$id}').accordion($options);");
}
运行这个部件。 这个方法注册必要的javascript并渲染相应的HTML代码。