用了這麼久的 Select2,總該寫一篇整理。老實說初學時覺得它不算特別順手,但也一直找不到更好用的下拉選單外掛。
Select2 有兩個主要版本,新版不僅外觀更新,方法與參數名稱也有調整,本文以新版為主。
官網:https://select2.github.io/
效果預覽:

需要 select2.full.js、select2.min.css(4.0.1)以及 jQuery 1.8.3 以上。若 jQuery 版本過低,部分功能會失效,例如清除功能所需的 allowClear: true。
另外,新版請使用 <select></select> 標籤。本地資料用 input 還能勉強跑,但 AJAX 遠端資料必須用 select。
placeholder 是佔位提示文字。要注意的是:只要想啟用清除功能,就一定要設定 placeholder,否則 allowClear 不會生效。
Select2 預設的資料欄位是 id 與 text,新版雖然可自訂,但沿用預設最省事。後端 JSON 最好直接轉成這兩個欄位,其他欄位則可當附加資訊保留。
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 }; //可再加自訂參數,如 stype: 'person'
},
processResults: function (data) {
return { results: data }; //若資料在 data.res 下,就回傳 data.res
},
cache: true
},
escapeMarkup: function (markup) { return markup; },
minimumInputLength: 1,
templateResult: formatRepo,
templateSelection: formatRepoSelection
});參數說明:
1. q: params.term —— params.term 是輸入框的內容,q 是送到伺服器的參數名,可自行命名或追加參數。
2. processResults 中的 results 才是最終交給 Select2 的資料,要依後端回應的結構調整。
3. minimumInputLength 是最少輸入幾個字才發請求;另有 maximumSelectionLength 限制最多可選幾筆。
4. escapeMarkup 為轉義處理。
5. templateResult 決定每個選項怎麼顯示,例如 function (repo) { return repo.text; }。
6. templateSelection 決定選人之後那一格怎麼顯示。
7. 新版對 JSON 結構要求較嚴格,格式須為 [{id:1, 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("你選中了選項"); }用 select2("data") 的好處是回傳的是完整物件,除了 id 與 text,其他自訂欄位也一併拿得到。
//清空
$("#c01-select").val(null).trigger("change");
$("#c01-select").val("你的placeholder").trigger("change");
//若用的是 input 標籤(本地資料),可直接
$("#c01-select").val('');
//啟停用
$("#c01-select").prop("disabled", false); //可用
$("#c01-select").prop("disabled", true); //不可用記得在改完值之後 trigger("change"),否則 Select2 的畫面不會跟著更新 —— 這是最常忘記的一步。
$("#c01-select").select2({ data: data, multiple: true });
1. 回呼名稱:formatResult/formatSelection(舊)→ templateResult/templateSelection(新)。
2. 初始化:
//舊版:使用 initSelection,若初始化時輸入框本身沒值(為空)則不會觸發
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()(新)。
4. 啟停用:$("select").enable(false)(舊)→ $("select").prop("disabled", true)(新)。
5. 主題樣式:新版樣式已更新,若想沿用舊觀,可設 theme: "classic"。
以上就是 Select2 的使用整理,希望對你的學習有幫助。