用了这么久的Select2插件，也该写篇文章总结总结。当初感觉Select2不是特别好用，但又找不到比它更好的下拉框插件。

在我的印象里Select2有2个版本，最新版本有一些新的特性，并且更新了一下方法参数，比最初版本要好看一些，本文针对新版本。

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

演示：

 

由于博客系统的原因，所以只能演示简单的功能。

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

最新版本的select2如果引用的版本较低的话，某些功能无法正常使用。比如：清除功能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("Jquery");

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控件介绍

 

这个插件是基于Select的扩展插件，能够提供更加丰富的功能和用户体验，它的github官网地址为:，具体的使用案例，可以参考地址：。

我们在整个框架里面，用到了很多Select2控件来处理内容的显示，包括单选的下拉列表（包括级联选择框）、复选的下拉列表、树形下拉列表等方式，界面效果如下所示。

1）编辑界面下的省份、城市、所在行政区的级联界面效果，选择省份，会加载对应省份下的城市，选择城市，会继续加载城市下的行政区，从而实现多级关联的下拉列表效果。

 

2）编辑界面下的多项选择下拉列表

但我们选择其中的内容的时候，系统自动显示出没有选择的列表数据，非常直观友好，如下所示。

 

3）树形列表的下拉列表

有时候，我们的一些数据可能有层次关系的，如所属机构、上层列表等等。

 

2、Select2控件的实际使用代码分析

1）基础界面代码及操作

使用select2控件，一般是在常规的select控件上，设置一下即可（设置它的class为select2）。

     
    
      
        
       重要级别        
       
            
                
       
    
      
     
 
     
    
      
        
       认可程度        
       
            
                
       
    
      
     

如果是固定列表，那么也就是设置它的Option内容即可，如下所示。

     
    
      
        
       吸烟        
       
            
                        吸烟                不吸烟                    
       
    
      
     

简单的select2控件初始化代码如下所示。

$(document).ready(function() {  $(".js-example-basic-single").select2();});

一般情况下，如果允许复选多个项目，那么设置 multiple="multiple"即可，如下代码所示。

2）异步数据绑定操作

一般情况下，我们的select控件的数据，是从里面动态加载的，因此一般是通过Ajax方式获取数据并进行绑定即可。

基于代码可重用性的考虑，我们编写一个公用的JS函数，用来减少绑定操作的代码，提高代码重用性。

//绑定字典内容到指定的Select控件function BindSelect(ctrlName, url) {    var control = $('#' + ctrlName);    //设置Select2的处理    control.select2({        allowClear: true,        formatResult: formatResult,        formatSelection: formatSelection,        escapeMarkup: function (m) {            return m;        }    });    //绑定Ajax的内容    $.getJSON(url, function (data) {        control.empty();//清空下拉框        $.each(data, function (i, item) {            control.append(" " + item.Text + "");        });    });}

这样，绑定公用字典模块的数据，也就可以通过下面进一步封装处理即可。

//绑定字典内容到指定的控件function BindDictItem(ctrlName, dictTypeName) {    var url = '/DictData/GetDictJson?dictTypeName=' + encodeURI(dictTypeName);    BindSelect(ctrlName, url);}

这样我们初始化Select2 控件，并动态绑定对应的字典值或者其他数据，则可以通过下面初始化代码即可实现。其中BindDictItem就是直接绑定字典内容的操作，BindSelect则是根据URL进行数据的获取并绑定，而$("#Province").on("change", function (e) {});这样的函数处理，就是处理选择内容变化的联动操作了。

//初始化字典信息（下拉列表）        function InitDictItem() {            //部分赋值参考                        BindDictItem("Area","市场分区");            BindDictItem("Industry", "客户行业");            BindDictItem("Grade","客户级别");            BindDictItem("CustomerType", "客户类型");            BindDictItem("Source", "客户来源");            BindDictItem("CreditStatus", "信用等级");            BindDictItem("Stage","客户阶段");            BindDictItem("Status", "客户状态");            BindDictItem("Importance",  "重要级别");                             // 绑定省份、城市、行政区（联动处理）            BindSelect("Province", "/Province/GetAllProvinceNameDictJson");            $("#Province").on("change", function (e) {                var provinceName = $("#Province").val();                BindSelect("City", "/City/GetCitysByProvinceNameDictJson?provinceName="+ provinceName);            });            $("#City").on("change", function (e) {                var cityName = $("#City").val();                BindSelect("District", "/District/GetDistrictByCityNameDictJson?cityName="+ cityName);            });        }

而其中MVC控制器返回的数据，我们是返回一个JSON数据列表给前端页面的，他们的数据格式如下所示。

[ { "Text": "", "Value": "" }, { "Text": "学术会议", "Value": "学术会议" }, { "Text": "朋友介绍", "Value": "朋友介绍" }, { "Text": "广告媒体", "Value": "广告媒体" } ]

这样前端页面绑定Select2控件的时候，就使用了JSON对象的属性即可。

//绑定Ajax的内容    $.getJSON(url, function (data) {        control.empty();//清空下拉框        $.each(data, function (i, item) {            control.append(" " + item.Text + "");        });    });

控制器的实现代码如下：

/// 
        /// 根据字典类型获取对应的字典数据，方便UI控件的绑定        /// 
        /// 字典类型名称        /// 
             public ActionResult GetDictJson(string dictTypeName)        {            List
     
       treeList = new List
      
       ();            CListItem pNode = new CListItem("", "");            treeList.Insert(0, pNode);            Dictionary
       
         dict = BLLFactory
        
         .Instance.GetDictByDictType(dictTypeName);            foreach (string key in dict.Keys)            {                treeList.Add(new CListItem(key, dict[key]));            }            return ToJsonContent(treeList);        }
        
       
      
     

3）树形列表的绑定操作

对于属性列表，如所属公司、所属部门机构等有层次性的数据，它的绑定操作也是类似的，如下代码所示。

//绑定添加界面的公司、部门、直属经理            BindSelect("Company_ID", "/User/GetMyCompanyDictJson?userId="+@Session["UserId"]);            $("#Company_ID").on("change", function (e) {                var companyid = $("#Company_ID").val();                BindSelect("Dept_ID", "/User/GetDeptDictJson?parentId="+ companyid);            });            $("#Dept_ID").on("change", function (e) {                var deptid = $("#Dept_ID").val();                BindSelect("PID", "/User/GetUserDictJson?deptId="+ deptid);            });

只是它们返回的数据，我们把它作为有缩进的显示内容而已。

[ { "Text": "爱奇迪集团", "Value": "1" }, { "Text": " 广州分公司", "Value": "3" }, { "Text": " 上海分公司", "Value": "4" }, { "Text": " 北京分公司", "Value": "5" } ]

或者如下所示

[ { "Text": "广州分公司", "Value": "3" }, { "Text": "总经办", "Value": "6" }, { "Text": "财务部", "Value": "7" }, { "Text": "工程部", "Value": "8" }, { "Text": "产品研发部", "Value": "9" }, { "Text": "　　开发一组", "Value": "14" }, { "Text": "　　开发二组", "Value": "15" }, { "Text": "　　测试组", "Value": "16" }, { "Text": "市场部", "Value": "10" }, { "Text": "　　市场一部", "Value": "23" }, { "Text": "　　市场二部", "Value": "24" }, { "Text": "综合部", "Value": "11" }, { "Text": "生产部", "Value": "12" }, { "Text": "人力资源部", "Value": "13" } ]

综上两个部分，我们可以看到它们的Text的内容，是根据层次关系进行空格增加，从而实现了层次关系的显示。

不过从这个界面效果上讲，这样的处理确实没有EasyUI里面，对下拉列表树的展示好看，也许可以利用更好的Bootstrap插件进行这个树形内容的展示。

  

4）select2控件的赋值处理

上面介绍的方法，都是介绍select2控件的初始化，绑定相关的数据，那么如果初始化界面后，我们绑定编辑界面的值的时候，就需要赋值给控件，让它显示真正需要显示的项目了。

如清空控件的方法如下所示。

//清空Select2控件的值            $("#PID").select2("val", "");            $("#Company_ID").select2("val", "");            $("#Dept_ID").select2("val", "");

如果对于多个控件，需要清除，则可以使用集合进行处理

var select2Ctrl = ["Area","Industry","Grade","CustomerType","Source","CreditStatus","Stage","Status","Importance"];            $.each(select2Ctrl, function (i, item) {                var ctrl = $("#" + item);                ctrl.select2("val", "");            });

给Select2 控件赋值，让它显示对应值内容的项目，那么操作也就和上面的类似了。

$("#CustomerType").select2("val", info.CustomerType);                 $("#Grade").select2("val", info.Grade);                 $("#CreditStatus").select2("val", info.CreditStatus);                 $("#Importance").select2("val", info.Importance);                 $("#IsPublic").select2("val", info.IsPublic);

如果需要级联显示的，那么做法增加一个onchange的函数处理就可以了，如下级联代码的赋值处理如下。

$("#Province").select2("val", info.Province); $("#Province").trigger('change');//联动 $("#City").select2("val", info.City); $("#City").trigger('change');//联动 $("#District").select2("val", info.District); $("#Company_ID1").select2("val", info.Company_ID);$("#Company_ID1").trigger('change');$("#Dept_ID1").select2("val", info.Dept_ID);$("#Dept_ID1").trigger('change');$("#PID1").select2("val", info.PID);

 

多个列表项目数据的绑定。

我们从案例里面可以看到，Select2支持多项值的选择，它们保存后会以逗号分开，如果我们需要在编辑的时候显示存储的多个记录，那么需要把字符串转换为数组列表才能进行正确绑定，如下所示。

$("#Permission").select2("val", info.Permission.split(','));

 

最后来两个整体性的界面效果，供参考。