小部件是视图里的可重用单元。
小部件是在视图中使用的，但是可能需要使用控制器传给他的模型，比如在渲染表单的时候。比如一般的时间拾取器就可以直接砸视图里加入如下代码就可以：
<?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脚本。