YII学习第八天，widget专题

关于widgets，他们在yii中的关系如下
system.web.widgets 系统自带最基本的widget
zii.widgets 是基本扩展
zii.widgets.grid 是基本扩展的重要分支
zii.widgets.jui 是插件扩展

一，system.web.widgets
包括：
CActiveForm
CAutoComplete
CClipWidget
CContentDecorator
CFilterWidget
CFlexWidget
CHtmlPurifier
CInputWidget
CMarkdown
CMaskedTextField
CMultiFileUpload
COutputCache
COutputProcessor
CStarRating
CTabView
CTextHighlighter
CTreeView
CWidget

1，CWidget
批注：CWidget是所有Widget的基类。CWidget是自包含组件，可以看出是MVC的简略版，CWidget相比Controller，既没有actions，也没有filters。
实现细节可参考 CBaseController and CBaseController::widget.

CWidget
2，CWidget实例（右侧页面）
CWidget是components下一个独立的文件夹（路径是：../components/widgets/）
有自己的controller和views。其中controller继承自CWidget，习惯命名为XXWidget.php（XXWidget extends CWidget）。

XXWidget.php有两种写法

/**********  方式一：  **********/
public function run() {
    //逻辑
    $this->render("fail_basic", array('summaryIdcs' => $summaryIdcs));
}

/**********  方式二：  **********/

3，实例

例如，在表单创建时

<?php $form=$this->beginWidget('CActiveForm', array(
  'id'=>'user-form',
  'enableAjaxValidation'=>false,
  'htmlOptions'=>array('enctype'=>'multipart/form-data'),
)); ?>
..body content that may be captured by the widget...
<?php $this->endWidget(); ?>
//或
<?php $this->widget('path.to.WidgetClass'); ?>

二，zii.widgets

默认情况下， widget 的视图文件位于包含了widget文件的 views 子目录之下。这些视图可以通过调用 CWidget::render()渲染，这一点和控制器很相似。唯一不同的是，widget的视图没有布局文件支持。
同时，view 文件中的 $this 指的是widget 实例而不是 controller 实例。

包括：
CBaseListView
CBreadcrumbs
CDetailView
CListView
CMenu
CPortlet

例一，

class testWidget extends CWidget
{    
    public function init()
    {
        //当视图中执行$this->beginWidget()时候会执行这个方法
        //可以在这里进行查询数据操作
    }
 
    public function run()
    {
        //当视图中执行$this->endWidget()的时候会执行这个方法
        //可以在这里进行渲染试图的操作，注意这里提到的视图是widget的视图
        //注意widget的视图是放在跟widget同级的views目录下面，例如下面的视图会放置在
        //  /protected/widget/test/views/test.php
        $this->render('test', array(
            'str'=>'WIDGET视图变量',
        ));
    }
}

CPortlet是widget的一种，专门负责展示

//在../components/RecentComments.php中

Yii::import('zii.widgets.CPortlet');
class RecentComments extends CPortlet
{
  public $title='Recent Comments';
  public $maxComments=10;

  public function getRecentComments()
  {
    return Comment::model()->findRecentComments($this->maxComments);
  }

  protected function renderContent()
  {
    $this->render('recentComments');
  }
}

//在../components/view/recentComments.php中
<ul>
  <?php foreach($this->getRecentComments() as $comment): ?>
  <li><?php echo $comment->authorLink; ?> on
    <?php echo CHtml::link(CHtml::encode($comment->post->title), $comment->getUrl()); ?>
  </li>
  <?php endforeach; ?>
</ul>

三，zii.widgets.grid

CButtonColumn
CCheckBoxColumn
CDataColumn
CGridColumn
CGridView
CLinkColumn


四，zii.widgets.jui
CJuiAccordion
CJuiAutoComplete
CJuiButton
CJuiDatePicker
CJuiDialog
CJuiDraggable
CJuiDroppable
CJuiInputWidget
CJuiProgressBar
CJuiResizable
CJuiSelectable
CJuiSlider
CJuiSliderInput
CJuiSortable
CJuiTabs
CJuiWidget