Yii Framework 开发教程(9) UI 小组件Widget 概述

迈不过友情╰ 2023-10-16 19:13 39阅读 0赞

和通常的应用程序开发框架一样，Yii Framework也提供了一组UI小组件（CWidget）来帮助程序员设计用户界面，小组是 CWidget 或其子类的实例.它是一个主要用于表现数据的组件.小组通常内嵌于一个视图来产生一些复杂而独立的用户界面.例如,一个日历小物件可用于渲染一个复杂的日历界面.小组件使用户界面更加可复用.

我们可以按如下视图脚本来使用一个小物件:

**\[php\]** [ view plain][view plain] [copy][view plain] [print][view plain] [?][view plain]

1.  <?php $this\->beginWidget('path.to.WidgetClass'); ?>
2.  ...可能会由小物件获取的内容主体...
3.  <?php $this\->endWidget(); >

<?php $this->beginWidget('path.to.WidgetClass'); ?>
    ...可能会由小物件获取的内容主体...
    <?php $this->endWidget();  >

或者

**\[php\]** [ view plain][view plain] [copy][view plain] [print][view plain] [?][view plain]

1.  <?php $this\->widget('path.to.WidgetClass'); ? >;

<?php $this->widget('path.to.WidgetClass'); ? >;

后者用于不需要任何 body 内容的组件.

小组件可通过配置来定制它的表现.这是通过调用 [CBaseController::beginWidget][CBaseController_beginWidget] 或 [CBaseController::widget][CBaseController_widget] 设置其初始化属性值来完成的.例如,当使用 [CMaskedTextField][] 小物件时,我们想指定被使用的 mask .我们通过传递一个携带这些属性初始化值的数组来实现.这里的数组的键是属性的名称,而数组的值则是小物件属性所对应的值.正如以下所示 :

**\[php\]** [ view plain][view plain] [copy][view plain] [print][view plain] [?][view plain]

1.  <?php
2.  $this\->widget('CMaskedTextField',array(
3.  'mask'=>'99/99/9999'
4.  ));
5.  ?>

<?php
    $this->widget('CMaskedTextField',array(
        'mask'=>'99/99/9999'
    ));
    ?>

继承  [CWidget][]  并覆盖其 [init()][init]  和  [run()][run]  方法,可以定义一个新的小物件:

**\[php\]** [ view plain][view plain] [copy][view plain] [print][view plain] [?][view plain]

1.  class MyWidget extends CWidget
2.  \{
3.  public function init()
4.  \{
5.  // 此方法会被 CController::beginWidget() 调用
6.  \}
7.  
8.  public function run()
9.  \{
10. // 此方法会被 CController::endWidget() 调用
11. \}
12. \}

class MyWidget extends CWidget
    {
        public function init()
        {
            // 此方法会被 CController::beginWidget() 调用
        }
    
        public function run()
        {
            // 此方法会被 CController::endWidget() 调用
        }
    }

小组件可以像一个控制器一样拥有它自己的视图.默认情况下,小物件的视图文件位于包含了小组件类文件目录的`views` 子目录之下.这些视图可以通过调用 [CWidget::render()][CWidget_render] 渲染,这一点和控制器很相似.唯一不同的是,小组件的视图没有布局文件支持。另外，小组件视图中的`$this`指向小物件实例而不是控制器实例。

在上一篇文章[Yii Framework 开发简明教程(8) 使用FormMode][Yii Framework _8_ _FormMode]l 说通过CController来处理用户提交事件，和Windows 桌面应用或ASP.Net做个类比， Yii 中视图View (HTML Form) 类似于WinForm或是Asp.Net 的Page。 控制类Controller类似Windows桌面应用或Asp.Net的事件处理（Code-Behind)类。 严格上来说，把 Yii 中视图View (HTML Form)比作Windows桌面中的WinFrom或是Asp.Net 的Page并不十分恰当，实际上Yii 中视图的整个HTML （或是body）对等于WinForm或是Page。 HTML Form 也只是CWidget的一个子类，对应到[CActiveForm][] UI组件，此外，Yii内置了下面CWidget类型：

[![201212122001][]][201212122001 1]

其中CJuiWidget (封装JQuery）和CInputWidget进一步分为：

[![201212122002][]][201212122002 1]

后面的教程将逐个介绍Yii提供的UI小组件的用法，除了这些内置的UI小组件外，Yii也支持自定义UI小组件

[view plain]: http://blog.csdn.net/mapdigit/article/details/8373316#
[CBaseController_beginWidget]: http://www.yiiframework.com/doc/api/1.1/CBaseController#beginWidget
[CBaseController_widget]: http://www.yiiframework.com/doc/api/1.1/CBaseController#widget
[CMaskedTextField]: http://www.yiiframework.com/doc/api/1.1/CMaskedTextField
[CWidget]: http://www.yiiframework.com/doc/api/1.1/CWidget
[init]: http://www.yiiframework.com/doc/api/1.1/CWidget#init
[run]: http://www.yiiframework.com/doc/api/1.1/CWidget#run
[CWidget_render]: http://www.yiiframework.com/doc/api/1.1/CWidget#render
[Yii Framework _8_ _FormMode]: http://www.imobilebbs.com/wordpress/archives/3911
[CActiveForm]: http://www.yiiframework.com/doc/api/1.1/CActiveForm
[201212122001]: http://www.imobilebbs.com/wordpress/wp-content/uploads/2012/12/201212122001.png
[201212122001 1]: http://www.imobilebbs.com/wordpress/archives/3926/attachment/201212122001
[201212122002]: http://www.imobilebbs.com/wordpress/wp-content/uploads/2012/12/2012121220021.png
[201212122002 1]: http://www.imobilebbs.com/wordpress/archives/3926/201212122002-2