Yii Widget 元件開發與使用指南

Yii Widget 元件開發與使用指南

說明 Yii 中 Widget 的建立、視圖渲染與生命週期方法。

目錄結構

在 /protected/widget/test/ 建立 testWidget.php，視圖置於 /protected/widget/test/views/test.php。

視圖中呼叫

beginWidget('application.widget.test.testWidget'); ?>
// ... Widget 內容區塊 ...
endWidget(); ?>

Widget 類別定義

class testWidget extends CWidget {
    public function init() {
        // beginWidget() 時執行，可進行資料查詢
    }

    public function run() {
        // endWidget() 時執行，渲染 Widget 視圖
        $this->render('test', array('str' => 'WIDGET 視圖變數'));
    }
}

生命週期：init() → 視圖主體內容 → run()。視圖檔案放在與 Widget 同層的 views 目錄下。