Select2下拉框總結

用了這么久的Select2插件，也該寫篇文章總結總結。當初感覺Select2不是特別好用，但又找不到比它更好的下拉框插件。

在我的印象里Select2有2個版本，最新版本有一些新的特性，並且更新了一下方法參數，比最初版本要好看一些，本文針對新版本。

官網：http://select2.github.io/ 

演示：

由於博客系統的原因，所以只能演示簡單的功能。

一.文件需要引入select2.full.js、select2.min.css（4.0.1版本）和jquery.1.8.3及以上

最新版本的select2如果引用的jquery版本較低的話，某些功能無法正常使用。比如：清除功能allowClear: true

最新版本請使用<select></select>標簽（對於本地化的數據你可以使用input，但ajax遠程數據必須使用select）

二.placeholder

placeholder占位提示文字，如果需要清除功能，則必須設置placeholder。

三.加載本地數據

select2默認的數據屬性是id、text，新版本可以自定義，但還是用默認的比較好。所以提供的json中最好轉換為id、text形式，當然可以添加其他屬性。

var data = [{ id: 0, text: 'enhancement' }, { id: 1, text: 'bug' }, { id: 2, text: 'duplicate' }, { id: 3, text: 'invalid' }, { id: 4, text: 'wontfix' }];
$("#c01-select").select2({
  data: data,
  placeholder:'請選擇',
  allowClear:true
})

四.加載遠程數據

$("#c01-select").select2({
  ajax: {
    url: "data.json",
    dataType: 'json',
    delay: 250,
    data: function (params) {
      return {
        q: params.term,
      };
    },
    processResults: function (data) {
      return {
        results: data
      };
    },
    cache: true
  },
  escapeMarkup: function (markup) { return markup; }, 
  minimumInputLength: 1,
  templateResult: formatRepo, 
  templateSelection: formatRepoSelection 
});

說明：

     1.q: params.term 查詢參數（params.term表示輸入框中內容，q發生到服務器的參數名；所以這里你可以添加自定義參數，如：stype:'person'）

     2.processResults中results: data返回數據（返回最終數據給results，如果我的數據在data.res下，則返回data.res。這個與服務器返回json有關）

     3.minimumInputLength 最小需要輸入多少個字符才進行查詢，與之相關的maximumSelectionLength表示最大輸入限制。

     4.escapeMarkup字符轉義處理

     5.templateResult返回結果回調function formatRepo(repo){return repo.text},這樣就可以將返回結果的的text顯示到下拉框里，當然你可以return repo.text+"1";等

     6.templateSelection選中項回調function formatRepoSelection(repo){return repo.text}

     7.關於返回的 json的格式：select2默認json格式為[{id:1,text:'text'},{id:2,text:'text'}]，新版嚴格要求這樣的格式，當然你可以添加列，如：[{id:1,text:'text',name:'liu'}]

五.獲取選中項

var res=$("#c01-select").select2("data")[0] ; //單選
var reslist=$("#c01-select").select2("data");    //多選
if(res==undefined)
{
     alert("你沒有選中任何項");
}
if(reslist.length)
{
     alert("你選中任何項");
}

六.清空選擇項和設置不可用

//清空選擇
$("#c01-select").val(null).trigger("change");
$("#c01-select").val("你的placeholder").trigger("change");//或者
//如果你使用的是input標簽（默認就是本地數據），你可以用$("#c01-select").val('');來清空選項

//disabled
$("#c01-select").prop("disabled", false);//可用
$("#c01-select").prop("disabled", true);//不可用

七.啟用多選

$("#c01-select").select2({
  data:data,
  multiple: true
});

多選演示：

由於博客系統原因只能演示選擇

八.下面簡單說明新版與老版對比

1.結果回調和選中回調名稱：formatResult、formatSelection（老版）；templateResult、templateSelection（新版）

2.初始化：

//老版，注意如果初始化時文本框中本身沒有值（為空），則不會觸發該方法
initSelection: function (element, callback) {
   var id = $(element).val();
   var data = { id: id, text: id};//這里是初始化的數據，你可以通過id來從服務器上獲取（ajax），再裝載進去
   callback(data);
}

//新版，直接給select添加option
$("#id").append(new Option("Jquery", 10001, false, true));
//或者
$("#id").append("<option value='10001'>Jquery</option>");

3.獲取或設置值：select2("val")（老版）；$("select").val()（新版）

推薦使用

var res = $("#id").select2("data");
//返回數組，單選就取res[0]；好處是不進可以獲取id、text還可以獲取其他屬性，如res[0].names

4.停用或啟用：$("select").enable(false);（老版）；$("select").prop("disabled", true);（新版）

5.主題樣式：新版的樣式已經更新，但如果想使用老版樣式則可以設置 theme: "classic"

十、在綁定插件中使用select2（2017年3月23日更新）

用得較多綁定插件有avalon、Vue等

盡量不要直接綁定到select標簽上，當然本地數據的input還是可以的，在 change事件中手動賦值

 

本文出處：http://www.cnblogs.com/liuxiaobo93/p/5112993.html