1轉自:https://www.jb51.net/article/95561.htm
用了這么久的Select2插件,也該寫篇文章總結總結。當初感覺Select2不是特別好用,但又找不到比它更好的下拉框插件。
在我的印象里Select2有2個版本,最新版本有一些新的特性,並且更新了一下方法參數,比最初版本要好看一些,本文針對新版本。
演示:
由於博客系統的原因,所以只能演示簡單的功能。
一.文件需要引入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形式,當然可以添加其他屬性。
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下拉框效果匯總進行學習。