Yii框架2.0的小部件

小部件是视图里的可重用单元。

小部件是在视图中使用的，但是可能需要使用控制器传给他的模型，比如在渲染表单的时候。比如一般的时间拾取器就可以直接砸视图里加入如下代码就可以：

<?php

use yii\jui\DatePicker;

?>

<?= DatePicker::widget(['name' => 'date']) ?>

如果用到model 就大致是这样的：

<?php

use yii\jui\DatePicker;

?>

<?= DatePicker::widget([

    'model' => $model,

    'attribute' => 'from_date',

    'language' => 'ru',

    'clientOptions' => [

        'dateFormat' => 'yy-mm-dd',

    ],

]) ?>

一些小部件可在[[yii\base\Widget::begin()]] 和 [[yii\base\Widget::end()]] 调用中使用数据内容。比如ActiveForm 小组件就是这样使用的。

<?php

use yii\widgets\ActiveForm;

use yii\helpers\Html;

?>



<?php $form = ActiveForm::begin(['id' => 'login-form']); ?>



    <?= $form->field($model, 'username') ?>



    <?= $form->field($model, 'password')->passwordInput() ?>



    <div class="form-group">

        <?= Html::submitButton('Login') ?>

    </div>



<?php ActiveForm::end(); ?>

和调用 [[yii\base\Widget::widget()]] 返回渲染结果不同， 调用 [[yii\base\Widget::begin()]] 方法返回一个可组建小部件内容的小部件实例。

创建小部件：

继承 yii\base\Widget 并实现 init 和 run方法就可以创建一个小部件。

1、创建一个像上面提到的时间选择器那样可以直接输出的小部件：

namespace app\components;



use yii\base\Widget;

use yii\helpers\Html;



class HelloWidget extends Widget {

    public $message;



    public function init() {

        parent::init();

        if(null == $this->message) {

            $this->message = 'Hello World';

        }

    }



    public function run() {

        return Html::encode($this->message);

    }

}

在模板中使用的代码是：

<?php

use app\components\HelloWidget;

?>

<?= HelloWidget::widget(['message'=>'This is a HelloWidget!'])?>

2、如果要创建一个用 begin 和 end 中使用的小部件：

amespace app\components;



use yii\base\Widget;

use yii\helpers\Html;



class HelloWidget extends Widget {

    public $message;



    public function init() {

        parent::init();

        ob_start();

    }



    public function field() {

        return Html::encode('这个是实例调用的方法！');

    }



    public function run() {

        $this->message = ob_get_clean();

        return Html::encode($this->message);

    }

}

模板里调用是这样的：

<?php

use yii\helpers\Html;

use app\components\HelloWidget;

?>



<?php echo Html::encode($message);?><br />

<?php $hello = HelloWidget::begin();?>

    这次使用的事begin 和 end方法。

    <?= $hello->field();?>

<?php HelloWidget::end();?>

有时小部件需要渲染很多内容，一种更好的办法是将内容放入一个视图文件， 然后调用[[yii\base\Widget::render()]]方法渲染该视图文件，小部件的视图文件默认存储在WidgetPath/views目录，WidgetPath代表小部件类文件所在的目录。 假如上述示例小部件类文件在@app/components下，会渲染@app/components/views/hello.php视图文件。 You may override 可以覆盖[[yii\base\Widget::getViewPath()]]方法自定义视图文件所在路径。

public function run(){

    return $this->render('hello');

}

最后提点应该注意的：

• 创建小部件时仍需要遵循MVC模式，通常逻辑代码在小部件类，展示内容在视图中。
• 小部件设计时应是独立的，也就是说使用一个小部件时候，可以直接丢弃它而不需要额外的处理。 但是当小部件需要外部资源如CSS, JavaScript, 图片等会比较棘手， 幸运的时候Yii提供 资源包 来解决这个问题。
• 当一个小部件只包含视图代码，它和视图很相似， 实际上，在这种情况下，唯一的区别是小部件是可以重用类，视图只是应用中使用的普通PHP脚本。