yii2組件之下拉框帶搜索功能的示例代碼（yii-select2）

更新時(shí)間：2017年09月08日 09:48:24 作者：白狼

本篇文章主要介紹了yii2組件之下拉框帶搜索功能的示例代碼（yii-select2），具有一定的參考價(jià)值，有興趣的可以了解一下

簡(jiǎn)單的小功能，但是用起來(lái)還是蠻爽的。分享出來(lái)讓更多的人有更快的開發(fā)效率，開開心心快樂編程。

如果你還沒有使用過composer，你可就out了，看我的教程分享，composer簡(jiǎn)直就是必備神奇有木有。都說(shuō)到這個(gè)點(diǎn)上了，我們趕緊使用composer進(jìn)行安裝吧。

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

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

有木有感覺很帥氣，當(dāng)然啦，遠(yuǎn)遠(yuǎn)不止，還很上檔次用起來(lái)效果也是杠杠的有木有。

好了好了，抓緊時(shí)間安裝，不然聊起來(lái)真是沒完沒了。

composer require kartik-v/yii2-widget-select2 "@dev"

特別說(shuō)明，因?yàn)檫@里安裝的dev版本，也就是開發(fā)版本，不穩(wěn)定版本，如果你的項(xiàng)目是git托管的，composer安裝下來(lái)之后這里記得刪掉 \vendor\kartik-v\yii2-widget-select2目錄下的.git文件，不然你提交不上去的哦
等他個(gè)大概5分鐘的樣子差不多了，安裝就好了，然后我們就可以像下面一樣開始使用了

//如果你的表單是ActiveForm，請(qǐng)使用

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

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

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

非ActiveFomr生成的更新數(shù)據(jù)的時(shí)候就需要默認(rèn)選中，好辦，加value值即可

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

但是如果你的表單是ActiveForm生成的，但是往往字段不是表字段怎么辦呢？更好辦啦，以上面的為例，你只需要指定$model->title = ['title1', 'title2'];即可

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

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

眼尖的注意到了，加了一個(gè)multiple選項(xiàng)。非ActiveForm生成的表單操作一致。

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

到此，我們已經(jīng)可以唱者NB的歌歡快的回家了

等等，好像忘記什么了，有眼尖的小伙伴可能注意到了，$data都是我們預(yù)先準(zhǔn)備好的數(shù)據(jù)，你說(shuō)這數(shù)據(jù)量萬(wàn)一很大的情況，不搞死人了嘛，那接下來(lái)讓我們看看如何實(shí)現(xiàn)異步搜索結(jié)果。舉一個(gè)例子，我們現(xiàn)在要查詢某一個(gè)書名，但是我們的書的數(shù)據(jù)量大概有100W，很簡(jiǎn)單，這需要我們根據(jù)你的搜索結(jié)果異步獲取下拉框里面的數(shù)據(jù)。未完待續(xù)，晚點(diǎn)做進(jìn)一步說(shuō)明。

來(lái)，上家伙，我們來(lái)看看如何使用異步搜索功能，工作中尤其是進(jìn)行關(guān)聯(lián)數(shù)據(jù)的時(shí)候其用途更是大大的，方便性嘛，看看就知道了，好用的不得了。

基本的使用方法就不多說(shuō)了，請(qǐng)看官們移步上文，我們這里繼續(xù)接著大侃大論。

我們先來(lái)預(yù)覽下異步搜索的效果圖

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

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

<?php
  echo $form->field($model, 'title')->widget(Select2::classname(), [
    'options' => ['placeholder' => '請(qǐng)輸入標(biāo)題名稱 ...'],
    'pluginOptions' => [
      'placeholder' => 'search ...',
      'allowClear' => true,
      'language' => [
        'errorLoading' => new JsExpression("function () { return 'Waiting...'; }"),
      ],
      'ajax' => [
        'url' => '這里是提供數(shù)據(jù)源的接口',
        '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; }'),
    ],
  ]);
?>

上面的代碼可直接復(fù)制使用，唯獨(dú)需要修改的就是ajax里對(duì)應(yīng)的url地址。下面我們看看controller層代碼是怎么提供數(shù)據(jù)的。

//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;
}

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: