Yii框架小部件（Widgets）用法實例詳解

本文實例講述了Yii框架小部件（Widgets）用法。分享給大家供大家參考，具體如下：

小部件 ¶

小部件是在 視圖 中使用的可重用單元， 使用面向?qū)ο蠓绞絼?chuàng)建復雜和可配置用戶界面單元。 例如，日期選擇器小部件可生成一個精致的允許用戶選擇日期的日期選擇器， 你只需要在視圖中插入如下代碼：

?php
use yii\jui\DatePicker;
?>
?= DatePicker::widget(['name' => 'date']) ?>

Yii提供許多優(yōu)秀的小部件，比如active form, menu, jQuery UI widgets, Twitter Bootstrap widgets。 接下來介紹小部件的基本知識，如果你想了解某個小部件請參考對應(yīng)的類API文檔。

使用小部件

小部件基本上在views中使用， 在視圖中可調(diào)用 yii\base\Widget::widget() 方法使用小部件。 該方法使用 配置 數(shù)組初始化小部件并返回小部件渲染后的結(jié)果。 例如如下代碼插入一個日期選擇器小部件，它配置為使用俄羅斯語， 輸入框內(nèi)容為$model的from_date屬性值。

?php
use yii\jui\DatePicker;
?>
?= DatePicker::widget([
  'model' => $model,
  'attribute' => 'from_date',
  'language' => 'ru',
  'dateFormat' => 'php:Y-m-d',
]) ?>

一些小部件可在yii\base\Widget::begin() 和 yii\base\Widget::end() 調(diào)用中使用數(shù)據(jù)內(nèi)容。 例如如下代碼使用yii\widgets\ActiveForm小部件生成一個登錄表單， 小部件會在begin() 和0 end()執(zhí)行處分別生成form>的開始標簽和結(jié)束標簽， 中間的任何代碼也會被渲染。

?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(); ?>

注意和調(diào)用 yii\base\Widget::widget() 返回渲染結(jié)果不同， 調(diào)用 yii\base\Widget::begin() 方法返回一個可組建小部件內(nèi)容的小部件實例。

注意： 當調(diào)用 yii\base\Widget::end() 的時候，一些小部件將使用 輸出緩沖 來調(diào)整封閉的內(nèi)容。因此，當調(diào)用 yii\base\Widget::begin() 和 yii\base\Widget::end() 時，最好在同一個視圖文件里。 不遵循這個規(guī)則可能會導致意外的輸出。

配置全局默認值

小部件的全局默認值可以通過 DI 容器配置:

\Yii::$container->set('yii\widgets\LinkPager', ['maxButtonCount' => 5]);

詳見 依賴注入容器 "實踐中的應(yīng)用" 一節(jié) 。

創(chuàng)建小部件

繼承 yii\base\Widget 類并覆蓋 yii\base\Widget::init() 和/或 yii\base\Widget::run() 方法可創(chuàng)建小部件。通常init() 方法處理小部件屬性， run() 方法包含小部件生成渲染結(jié)果的代碼。 渲染結(jié)果可在run()方法中直接"echoed"輸出或以字符串返回。

如下代碼中HelloWidget編碼并顯示賦給message 屬性的值， 如果屬性沒有被賦值，默認會顯示"Hello World"。

namespace app\components;
 
use yii\base\Widget;
use yii\helpers\Html;
 
class HelloWidget extends Widget
{
  public $message;
 
  public function init()
  {
    parent::init();
    if ($this->message === null) {
      $this->message = 'Hello World';
    }
  }
 
  public function run()
  {
    return Html::encode($this->message);
  }
}

使用這個小部件只需在視圖中簡單使用如下代碼:

?php
use app\components\HelloWidget;
?>
?= HelloWidget::widget(['message' => 'Good morning']) ?>

以下是另一種可在begin() 和 end()調(diào)用中使用的HelloWidget， HTML編碼內(nèi)容然后顯示。

namespace app\components;
 
use yii\base\Widget;
use yii\helpers\Html;
 
class HelloWidget extends Widget
{
  public function init()
  {
    parent::init();
    ob_start();
  }
 
  public function run()
  {
    $content = ob_get_clean();
    return Html::encode($content);
  }
}

如上所示，PHP輸出緩沖在init()啟動，所有在init() 和 run()方法之間的輸出內(nèi)容都會被獲取，并在run()處理和返回。

信息： 當你調(diào)用 yii\base\Widget::begin() 時會創(chuàng)建一個新的小部件 實例并在構(gòu)造結(jié)束時調(diào)用init()方法， 在end()時會調(diào)用run()方法并輸出返回結(jié)果。

如下代碼顯示如何使用這種 HelloWidget:

?php
use app\components\HelloWidget;
?>
?php HelloWidget::begin(); ?>
 
  content that may contain tag>'s
 
?php HelloWidget::end(); ?>

有時小部件需要渲染很多內(nèi)容，一種更好的辦法是將內(nèi)容放入一個視圖文件， 然后調(diào)用yii\base\Widget::render()方法渲染該視圖文件， 例如：

public function run()
{
  return $this->render('hello');
}

小部件的視圖文件默認存儲在WidgetPath/views目錄，WidgetPath代表小部件類文件所在的目錄。 假如上述示例小部件類文件在@app/components下， 會渲染@app/components/views/hello.php視圖文件。 You may override 可以覆蓋yii\base\Widget::getViewPath()方法自定義視圖文件所在路徑。

最佳實踐

小部件是面向?qū)ο蠓绞絹碇赜靡晥D代碼。

創(chuàng)建小部件時仍需要遵循MVC模式，通常邏輯代碼在小部件類， 展示內(nèi)容在視圖中。

小部件設(shè)計時應(yīng)是獨立的，也就是說使用一個小部件時候， 可以直接丟棄它而不需要額外的處理。 但是當小部件需要外部資源如CSS, JavaScript, 圖片等會比較棘手， 幸運的時候Yii提供 資源包 來解決這個問題。

當一個小部件只包含視圖代碼，它和視圖很相似， 實際上，在這種情況下，唯一的區(qū)別是小部件是可以重用類， 視圖只是應(yīng)用中使用的普通PHP腳本。

更多關(guān)于Yii相關(guān)內(nèi)容感興趣的讀者可查看本站專題：《Yii框架入門及常用技巧總結(jié)》、《php優(yōu)秀開發(fā)框架總結(jié)》、《smarty模板入門基礎(chǔ)教程》、《php面向?qū)ο蟪绦蛟O(shè)計入門教程》、《php字符串(string)用法總結(jié)》、《php+mysql數(shù)據(jù)庫操作入門教程》及《php常見數(shù)據(jù)庫操作技巧匯總》

希望本文所述對大家基于Yii框架的PHP程序設(shè)計有所幫助。