jQuery的下拉選select2插件用法

1轉自:https://www.jb51.net/article/95561.htmcss

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

在個人印象裏Select2有2個版本,最新版本有一些新的特性,而且更新了一下方法參數,比最第一版本要好看一些,本文針對新版本。ajax

演示:
json

因爲博客系統的緣由,因此只能演示簡單的功能。數組

一.文件須要引入select2.full.js、select2.min.css(4.0.1版本)和jquery.1.8.3及以上服務器

最新版本的select2若是引用的jquery版本較低的話,某些功能沒法正常使用。好比:清除功能allowClear: trueapp

最新版本請使用<select></select>標籤(對於本地化的數據你可使用input,但ajax遠程數據必須使用select)學習

 

 

二.placeholderurl

 

placeholder佔位提示文字,若是須要清楚功能,則必須設置placeholder。spa

 

三.加載本地數據

 

select2默認的數據屬性是id、text,新版本能夠自定義,但仍是用默認的比較好。因此提供的json中最好轉換爲id、text形式,固然能夠添加其餘屬性。

 

?
1
2
3
4
5
6
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
})

 

四.加載遠程數據

 

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
$( "#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'}]

 

五.獲取選中項

 

?
1
2
3
4
5
6
7
8
9
10
var res=$( "#c01-select" ).select2( "data" )[0] ; //單選
var reslist=$( "#c01-select" ).select2( "data" ); //多選
if (res==undefined)
{
  alert( "你沒有選中任何項" );
}
if (reslist.length)
{
  alert( "你選中任何項" );
}

 

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

 

?
1
2
3
4
5
6
7
//清空選擇
$( "#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 ); //不可用

 

七.啓用多選

 

?
1
2
3
4
$( "#c01-select" ).select2({
  data:data,
  multiple: true
});

 

多選演示:

 

 

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

 

1.結果回調和選中回調名稱:formatResult、formatSelection(老版);templateResult、templateSelection(新版)

 

2.初始化:

 

?
1
2
3
4
5
6
7
8
9
10
11
//老版,注意若是初始化時文本框中自己沒有值(爲空),則不會觸發該方法
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()(新版)

 

推薦使用

 

?
1
2
var res = $( "#id" ).select2( "data" );
//返回數組,單選就取res[0];好處是不進能夠獲取id、text還能夠獲取其餘屬性,如res[0].names

 

4.停用或啓用:$("select").enable(false);(老版);$("select").prop("disabled", true);(新版)

 

5.主題樣式:新版的樣式已經更新,但若是想使用老版樣式則能夠設置 theme: "classic"

 

若是你們還想深刻學習,能夠點擊jquery下拉框效果彙總JavaScript下拉框效果彙總進行學習。

相關文章
相關標籤/搜索