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

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

<?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脚本。
05-11 07:52