yii2組件之下拉框帶搜索功能（yii-select2）

簡單的小功能，但是用起來還是蠻爽的。分享出來讓更多的人有更快的開發效率，開開心心快樂編程。

如果你還沒有使用過composer，你可就out了，看我的教程分享，composer簡直就是必備神奇有木有。都說到這個點上了，我們趕緊使用composer進行安裝吧。

不急，先來看看效果圖是啥樣的，不然都沒心情沒欲望看下去。

啥玩意，不感興趣？繼續看嘛，看完再操作一邊才能覺得好在哪里。

有木有感覺很帥氣，當然啦，遠遠不止，還很上檔次用起來效果也是杠杠的有木有。

好了好了，抓緊時間安裝，不然聊起來真是沒完沒了。

composer require kartik-v/yii2-widget-select2 "@dev"
#特別說明，因為這里安裝的dev版本，也就是開發版本，不穩定版本，如果你的項目是git托管的，composer安裝下來之后這里記得刪掉 \vendor\kartik-v\yii2-widget-select2目錄下的.git文件，不然你提交不上去的哦

等他個大概5分鍾的樣子差不多了，安裝就好了，然后我們就可以像下面一樣開始使用了

//如果你的表單是ActiveForm，請使用

use kartik\select2\Select2; 
//$data是鍵值對數組哦，key-value ,下面所聲明的所有$data均為鍵值對數組，以該數組為例 
$data = [2 => 'widget', 3 => 'dropDownList', 4 => 'yii2']; 
echo $form->field($model, 'title')->widget(Select2::classname(), [  
    'data' => $data, 
    'options' => ['placeholder' => '請選擇 ...'], 
]);

//如果你的表單是非ActiveForm,可以參考下面的

use kartik\select2\Select2; 
echo Select2::widget([ 'name' => 'title', 
    'data' => $data, 
    'options' => ['placeholder' => '請選擇...'] 
]);

#非ActiveFomr生成的更新數據的時候就需要默認選中，好辦，加value值即可

use kartik\select2\Select2; 
echo Select2::widget([ 
    'name' => 'title', 
    'value' => 2, 
    'data' => $data, 
    'options' => ['placeholder' => '請選擇...'] 
]);
#但是如果你的表單是ActiveForm生成的，但是往往字段不是表字段怎么辦呢？更好辦啦，以上面的為例，你只需要指定$model->title = ['title1', 'title2'];即可

 

基本上就是這么回事，我們也就很簡單的實現了下拉選擇並可搜索的功能。但是，咋又冒出來了個但是呢，但是剛才是我們想的，事實是這樣的，小編妹子說了，你這能不能操作再方便點，一次選擇一個太麻煩了，能不能多選呀？為了實現你那ZB的伎倆，好吧，確實也簡單，一行代碼解決掉。

echo $form->field($model, 'title')->widget(Select2::classname(), [ 
    'data' => $data, 
    'options' => ['multiple' => true, 'placeholder' => '請選擇 ...'], 
]);
#多選的添加默認值同上

眼尖的注意到了，加了一個multiple選項。非ActiveForm生成的表單操作一致。

我們看看效果是怎么樣的。

到此，我們已經可以唱者NB的歌歡快的回家了

等等，好像忘記什么了，有眼尖的小伙伴可能注意到了，$data都是我們預先准備好的數據，你說這數據量萬一很大的情況，不搞死人了嘛，那接下來讓我們看看如何實現異步搜索結果。舉一個例子，我們現在要查詢某一個書名，但是我們的書的數據量大概有100W，很簡單，這需要我們根據你的搜索結果異步獲取下拉框里面的數據。未完待續，晚點做進一步說明。

華麗的分割線

---

來，上家伙，我們來看看如何使用異步搜索功能，工作中尤其是進行關聯數據的時候其用途更是大大的，方便性嘛，看看就知道了，好用的不得了。

基本的使用方法就不多說了，請看官們移步上文，我們這里繼續接着大侃大論。

我們先來預覽下異步搜索的效果圖

注意哦，圖中標記的部分是我們通過輸入的關鍵詞搜索出來的，異步這效果呢，我截圖上來估計你也看不到效果，動圖我還不會，不知道怎么搞的，要說具體是啥效果嗎，相信大多數人也是明白滴，這就叫做只可意會，言談不出來。好了，我們干脆直接上代碼看具體操作吧。

// view層
use kartik\select2\Select2;
use yii\web\JsExpression;

<?php
    echo $form->field($model, 'title')->widget(Select2::classname(), [
        'options' => ['placeholder' => '請輸入標題名稱 ...'],
        'pluginOptions' => [
            'placeholder' => 'search ...',
            'allowClear' => true,
            'language' => [
                'errorLoading' => new JsExpression("function () { return 'Waiting...'; }"),
            ],
            'ajax' => [
                'url' => '這里是提供數據源的接口',
                'dataType' => 'json',
                'data' => new JsExpression('function(params) { return {q:params.term}; }')
            ],
            'escapeMarkup' => new JsExpression('function (markup) { return markup; }'),
            'templateResult' => new JsExpression('function(res) { return res.text; }'),
            'templateSelection' => new JsExpression('function (res) { return res.text; }'),
        ],
    ]);
?>

上面的代碼可直接復制使用，唯獨需要修改的就是ajax里對應的url地址。下面我們看看controller層代碼是怎么提供數據的。

//controller層
public function actionSearchTitle ($q)
{
    \Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;
    $out = ['results' => ['id' => '', 'text' => '']];
    if (!$q) {
        return $out;
    }

    $data = Article::find()
                ->select('id, title as text')
                ->andFilterWhere(['like', 'title', $q])
                ->limit(50)
                ->asArray()
                ->all();
                
    $out['results'] = array_values($data);

    return $out;
}