Select2.js下拉框使用小結,select2.js下拉框
用了這麼久的Select2外掛程式,也該寫篇文章總結總結。當初感覺Select2不是特別好用,但又找不到比它更好的下拉框外掛程式。
在我的印象裡Select2有2個版本,最新版本有一些新的特性,並且更新了一下方法參數,比最初版本要好看一些,本文針對新版本。
官網:http://select2.github.io/
示範:
由於部落格系統的原因,所以只能示範簡單的功能。
一.檔案需要引入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形式,當然可以添加其他屬性。
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("<option value='10001'>Jquery</option>");
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"
以上就是本文的全部內容,希望對大家的學習有所協助,也希望大家多多支援幫客之家。