JS组件系列——Bootstrap Select2组件使用小结

前言：在介绍select组件的时候，博主之前分享过一篇 JS组件系列——两种bootstrap multiselect组件大比拼 ，这两个组件的功能确实很强大，只可惜没有图文结合的效果（也就是将图片放入到select里面随着文字一起显示）。前两天做一个菜单图标选择的功能，就要用到这个图文选择的功能。于是乎又是找啊找。终于不负所望，找到了我们伟大的select2组件。今天分享下这个组件的一些用法和特性。

一、组件说明以及API说明

Select2使用示例地址： https://select2.github.io/examples.html

Select2参数文档说明： https://select2.github.io/options.html

Select2源码： https://github.com/select2/select2

二、组件特性效果展示

一些通用的单选、多选、分组等功能这里就不多做介绍了，multiselect这方面是强项。重点介绍下select2的一些特性效果：

1、多选效果

可以设置最多只能选几个

2、图文结合的效果

3、远程搜索功能（即在用户输入搜索内容时动态去后台取数据）

输入内容前

输入空格搜索出全部

滚动条滑动到底部自动加载剩余项

输入文本动态去后台过滤

更高级的用法如：

其实使用起来也不难，就是一个拼html的过程。

三、代码示例

1、多选效果

select2的多选很简单，设置一个属性就好了。

 　　

    
    

    
    

　　
         
              用户管理
              角色管理
              部门管理
              菜单管理
         
         
              订单查询
              订单导入
              订单删除
              订单撤销
         
         
              基础数据维护
          
     

    //多选
    $("#sel_menu2").select2({
        tags: true,
        maximumSelectionLength: 3  //最多能够选择的个数
    });

2、图文结合的效果

<select id="sel_menu" class="js-example-templating js-states form-control">
             <optgroup label="系统设置">
                 <option value="1">用户管理option>
                 <option value="2">角色管理option>
                 <option value="3">部门管理option>
                 <option value="4">菜单管理option>
             optgroup>
             <optgroup label="订单管理">
                 <option value="5">订单查询option>
                 <option value="6">订单导入option>
                 <option value="7">订单删除option>
                 <option value="8">订单撤销option>
             optgroup>
             <optgroup label="基础数据">
                 <option value="9">基础数据维护option>
             optgroup>
         select>

$(function () {
    //带图片
    $("#sel_menu").select2({
        templateResult: formatState,
        templateSelection: formatState
    });
});

function formatState(state) {
    if (!state.id) { return state.text; }
    var $state = $(
      ''.ico" class="img-flag" /> ' + state.text + ''
    );
    return $state;
};

3、远程搜索功能（即在用户输入搜索内容时动态去后台取数据）

 <select id="sel_menu3" class="js-data-example-ajax form-control">
      <option value="3620194" selected="selected">请选择option>
 select>

$(function () {
    //远程筛选
    $("#sel_menu3").select2({
        ajax: {
            url: "/Home/GetProvinces",
            dataType: 'json',
            delay: 250,
            data: function (params) {
                return {
                    q: params.term, // search term
                    page: params.page
                };
            },
            processResults: function (data, params) {
                params.page = params.page || 1;

                return {
                    results: data.items,
                    pagination: {
                        more: (params.page * 10) < data.total_count
                    }
                };
            },
            cache: true
        },
        escapeMarkup: function (markup) { return markup; }, // let our custom formatter work
        minimumInputLength: 1,
        templateResult: formatRepoProvince, // omitted for brevity, see the source of this page
        templateSelection: formatRepoProvince // omitted for brevity, see the source of this page
    });
});

function formatRepoProvince(repo) {
    if (repo.loading) return repo.text;
    var markup = "
"+repo.name+"
";
    return markup;
}

这里有要注意的一个地方就是processResults属性对应的方法有一个more属性用于是否分页显示的，这里的值要和你需要一次显示的值的条数匹配。

后台对应的方法如下：

public List<string> lstProvince = new List<string>() {"北京市","天津市","重庆市","上海市","河北省","山西省","辽宁省","吉林省","黑龙江省","江苏省","浙江省","安徽省","福建省","江西省","山东省","河南省","湖北省","湖南省","广东省","海南省","四川省","贵州省","云南省","陕西省","甘肃省","青海省","台湾省","内蒙古自治区","广西壮族自治区","西藏自治区","宁夏回族自治区","新疆维吾尔自治区","香港特别行政区","澳门特别行政区" };
        public JsonResult GetProvinces(string q, string page)
         {
            var lstRes = new List();
            for (var i = 0; i < 30; i++)
            {
                var oProvince = new Province();
                oProvince.id = i;
                oProvince.name = lstProvince[i];
                lstRes.Add(oProvince);
            }
            if (!string.IsNullOrEmpty(q.Trim()))
            {
                lstRes = lstRes.Where(x => x.name.Contains(q)).ToList();
            }
            var lstCurPageRes = string.IsNullOrEmpty(page) ? lstRes.Take(10) : lstRes.Skip(Convert.ToInt32(page) * 10 - 10).Take(10);
            return Json(new { items = lstCurPageRes, total_count = lstRes.Count }, JsonRequestBehavior.AllowGet);
        }

原文地址