新聞中心
這篇文章主要介紹“如何操作Yii框架小部件(Widgets)”,在日常操作中,相信很多人在如何操作Yii框架小部件(Widgets)問題上存在疑惑,小編查閱了各式資料,整理出簡(jiǎn)單好用的操作方法,希望對(duì)大家解答”如何操作Yii框架小部件(Widgets)”的疑惑有所幫助!接下來,請(qǐng)跟著小編一起來學(xué)習(xí)吧!

小部件 ¶
小部件是在 視圖 中使用的可重用單元, 使用面向?qū)ο蠓绞絼?chuàng)建復(fù)雜和可配置用戶界面單元。 例如,日期選擇器小部件可生成一個(gè)精致的允許用戶選擇日期的日期選擇器, 你只需要在視圖中插入如下代碼:
= DatePicker::widget(['name' => 'date']) ?>
Yii提供許多優(yōu)秀的小部件,比如active form, menu, jQuery UI widgets, Twitter Bootstrap widgets。 接下來介紹小部件的基本知識(shí),如果你想了解某個(gè)小部件請(qǐng)參考對(duì)應(yīng)的類API文檔。
使用小部件
小部件基本上在views中使用, 在視圖中可調(diào)用 yii\base\Widget::widget() 方法使用小部件。 該方法使用 配置 數(shù)組初始化小部件并返回小部件渲染后的結(jié)果。 例如如下代碼插入一個(gè)日期選擇器小部件,它配置為使用俄羅斯語, 輸入框內(nèi)容為$model的from_date屬性值。
= 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小部件生成一個(gè)登錄表單, 小部件會(huì)在begin() 和0end()執(zhí)行處分別生成的開始標(biāo)簽和結(jié)束標(biāo)簽, 中間的任何代碼也會(huì)被渲染。
'login-form']); ?> = $form->field($model, 'username') ?> = $form->field($model, 'password')->passwordInput() ?>= Html::submitButton('Login') ?>
注意和調(diào)用 yii\base\Widget::widget() 返回渲染結(jié)果不同, 調(diào)用 yii\base\Widget::begin() 方法返回一個(gè)可組建小部件內(nèi)容的小部件實(shí)例。
注意:當(dāng)調(diào)用 yii\base\Widget::end() 的時(shí)候,一些小部件將使用 輸出緩沖 來調(diào)整封閉的內(nèi)容。因此,當(dāng)調(diào)用 yii\base\Widget::begin() 和 yii\base\Widget::end() 時(shí),好在同一個(gè)視圖文件里。 不遵循這個(gè)規(guī)則可能會(huì)導(dǎo)致意外的輸出。
配置全局默認(rèn)值
小部件的全局默認(rèn)值可以通過 DI 容器配置:
\Yii::$container->set('yii\widgets\LinkPager', ['maxButtonCount' => 5]);詳見 依賴注入容器 "實(shí)踐中的應(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 屬性的值, 如果屬性沒有被賦值,默認(rèn)會(huì)顯示"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);
}
}使用這個(gè)小部件只需在視圖中簡(jiǎn)單使用如下代碼:
= 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()啟動(dòng),所有在init() 和run()方法之間的輸出內(nèi)容都會(huì)被獲取,并在run()處理和返回。
信息:當(dāng)你調(diào)用 yii\base\Widget::begin() 時(shí)會(huì)創(chuàng)建一個(gè)新的小部件 實(shí)例并在構(gòu)造結(jié)束時(shí)調(diào)用
init()方法, 在end()時(shí)會(huì)調(diào)用run()方法并輸出返回結(jié)果。
如下代碼顯示如何使用這種HelloWidget:
content that may contain's
有時(shí)小部件需要渲染很多內(nèi)容,一種更好的辦法是將內(nèi)容放入一個(gè)視圖文件, 然后調(diào)用yii\base\Widget::render()方法渲染該視圖文件, 例如:
public function run()
{
return $this->render('hello');
}小部件的視圖文件默認(rèn)存儲(chǔ)在WidgetPath/views目錄,WidgetPath代表小部件類文件所在的目錄。 假如上述示例小部件類文件在@app/components下, 會(huì)渲染@app/components/views/hello.php視圖文件。 You may override 可以覆蓋yii\base\Widget::getViewPath()方法自定義視圖文件所在路徑。
很好實(shí)踐
小部件是面向?qū)ο蠓绞絹碇赜靡晥D代碼。
創(chuàng)建小部件時(shí)仍需要遵循MVC模式,通常邏輯代碼在小部件類, 展示內(nèi)容在視圖中。
小部件設(shè)計(jì)時(shí)應(yīng)是獨(dú)立的,也就是說使用一個(gè)小部件時(shí)候, 可以直接丟棄它而不需要額外的處理。 但是當(dāng)小部件需要外部資源如CSS, JavaScript, 圖片等會(huì)比較棘手, 幸運(yùn)的時(shí)候Yii提供 資源包 來解決這個(gè)問題。
當(dāng)一個(gè)小部件只包含視圖代碼,它和視圖很相似, 實(shí)際上,在這種情況下,的區(qū)別是小部件是可以重用類, 視圖只是應(yīng)用中使用的普通PHP腳本。
到此,關(guān)于“如何操作Yii框架小部件(Widgets)”的學(xué)習(xí)就結(jié)束了,希望能夠解決大家的疑惑。理論與實(shí)踐的搭配能更好的幫助大家學(xué)習(xí),快去試試吧!若想繼續(xù)學(xué)習(xí)更多相關(guān)知識(shí),請(qǐng)繼續(xù)關(guān)注創(chuàng)新互聯(lián)網(wǎng)站,小編會(huì)繼續(xù)努力為大家?guī)砀鄬?shí)用的文章!
本文名稱:如何操作Yii框架小部件(Widgets)-創(chuàng)新互聯(lián)
鏈接分享:http://www.dlmjj.cn/article/hpedo.html


咨詢
建站咨詢
