本文分享一個可遞迴生成任意層級的聯動下拉選單外掛 jquery.select.more.js,並附使用說明文件。
(function($){
$.fn.doselectmore = function(settings) {
var dfop ={
namekey: "name", // 數據顯示名稱欄位
pnamekey: "name", // 上級主鍵欄位
idkey: "id", // 主鍵欄位
selectname:"sel", // 選擇框名稱前綴
method: "POST",
datatype: "json",
param:{},
pval:null, // 第一級的上級節點值
chckval:null, // 默認選中值
chckvalarry:null,
pname:false,
nname:false,
vl:0, // 當前層級
url: false, // 遠程數據來源
data: false // 本地數據
};
$.extend(dfop, settings);
var me = $(this);
if(!dfop.nname){
dfop.nname = (dfop.selectname+(dfop.vl+1));
}
if((!dfop.pname)&&dfop.vl>0){
dfop.pname = dfop.selectname+(dfop.vl-1);
}
if(!dfop.data){
if (dfop.url) {
$.ajax({
type: dfop.method,
url: dfop.url,
data: dfop.param,
dataType: dfop.datatype,
success: function(data){
dfop.data=data;
selectmorebuilder(me,dfop);
},
error:(function(request,status,err){
var errText = request.responseText;
var ErrMessage = "頁面出現"+request.status+"錯誤信息,\n";
ErrMessage += "錯誤內容為:"+request.statusText+"\n"+errText.substring(errText.indexOf("<pre>")+5,errText.indexOf("</pre>"));
alert(ErrMessage);
})
});
}
}else{
selectmorebuilder(me,dfop);
}
接著是核心的建構函式 selectmorebuilder,它負責三件事:回溯計算預設選中路徑、建立 select 元素、綁定 change 事件以遞迴生成下一層。
function selectmorebuilder(thisme,df) {
// 若指定了 chckval,向上回溯整條路徑,得到每一層應選中的值
if(df.chckval!=null&&df.chckvalarry==null){
var pid=df.chckval;
var k=1;
df.chckvalarry = new Array();
df.chckvalarry.push(pid);
while(k>0){
k=0;
$.each(df.data, function(i, item){
if(item[df.idkey]==pid&&item[df.pnamekey]!=df.pval){
pid=item[df.pnamekey];
df.chckvalarry.unshift(pid);
k++;
}
});
}
}
var select = $("<select></select>");
select.attr({
name:df.selectname+dfop.vl,
id:df.selectname+dfop.vl,
nname:df.nname,
pname:df.pname,
vl:df.vl
});
var sdiv = null;
if (dfop.vl == 0) {
sdiv = $("<div></div>");
thisme.after(sdiv).remove();
sdiv.append("<input type=\"hidden\" name=\"" + df.selectname + "\">");
sdiv.append(select);
sdiv.get(0).t=df;
}else{
thisme.removeselectmore();
sdiv = $("input[name="+df.selectname+"]").parent();
sdiv.append(select);
}
select.empty();
var counti = 0;
$.each(df.data, function(i, item){
if(item[df.pnamekey]==df.pval){
select.append("<option value='"+item[df.idkey]+"'>"+item[df.namekey]+"</option>");
counti++;
}
});
if (counti == 0) {
select.remove(); // 沒有子項則移除該層,聯動到此結束
}
else {
select.change(function(){
var nselect = $("#" + $(this).attr("nname"));
if (nselect.length == 0) {
nselect = $("<select></select>");
sdiv.append(nselect);
}
nselect.doselectmore({
namekey: df.namekey,
pnamekey: df.pnamekey,
idkey: df.idkey,
selectname: df.selectname,
param: df.param,
pval: $(this).val(),
vl: df.vl + 1,
chckvalarry:sdiv.get(0).t.chckvalarry,
data: df.data
});
});
if(df.chckvalarry!=null){
if(df.chckvalarry.length>=df.vl)
select.val(df.chckvalarry[df.vl]);
}
select.change();
$("input[type=hidden][name="+df.selectname+"]").val($("input[type=hidden][name="+df.selectname+"]").getselectmoreval());
}
}
最後是取值、設值與移除三個輔助方法:
// 取得目前選中的最末層值
$.fn.getselectmoreval = function(){
var me = $(this);
if(me.size()==0) return;
var sdiv = me.parent();
if(sdiv.size()==0) return;
var df = sdiv.get(0).t;
var nselect = $("#" + df.selectname+df.vl);
var v = null;
while(nselect.size()>0){
v = nselect.val();
nselect = $("#" +nselect.attr("nname"));
}
return v;
};
// 依最末層 id 設定整條聯動路徑
$.fn.setselectmoreval = function(idv){
var me = $(this);
if(me.size()==0) return;
var sdiv = me.parent();
if(sdiv.size()==0) return;
var df = sdiv.get(0).t;
df.chckval=idv;
if(idv!=null){
var pid=df.chckval;
var k=1;
df.chckvalarry = new Array();
df.chckvalarry.push(pid);
while(k>0){
k=0;
$.each(df.data, function(i, item){
if(item[df.idkey]==pid&&item[df.pnamekey]!=df.pval){
pid=item[df.pnamekey];
df.chckvalarry.unshift(pid);
k++;
}
});
}
}
sdiv.get(0).t=df;
var nselect = $("#" + df.selectname+df.vl);
nselect.val(df.chckvalarry[0]);
nselect.change();
};
// 遞迴移除後續所有層級
$.fn.removeselectmore = function(){
if($(this).attr("nname")!=null){
$("#"+$(this).attr("nname")).removeselectmore();
}
$(this).remove();
};
})(jQuery);
方法名:doselectmore 用途:把一個元素實例化為多級聯動下拉選單
參數說明(※ 為必填,★ 為二選一,? 為非必須):
/**
※namekey: 數據類型顯示名稱
※pnamekey: 數據上級主鍵名稱
※idkey: 數據主鍵名稱
※selectname: 選擇框名稱
※pval: 第一級別上級節點值
?chckval: 默認選擇
★url: false(遠程取數)
?param: url 使用時傳入參數
★data: false(本地數據)
**/
$("input[name=illegbasinfo]").doselectmore({
url:'../../../abc/dic/illbasinfo/loadall.do',
pval:0,
namekey: "illegbasinfo",
pnamekey: "parillegbasid",
idkey: "illegbasinfoid",
selectname:"illegbasinfo"
});
getselectmoreval() 取得選中對象的值:
$("input[name=test1]").click(function(){
alert($("input[name=illegbasinfo]").getselectmoreval());
});
setselectmoreval(val) 為聯動選單設定值(會自動回溯並展開整條路徑):
$("input[name=test2]").click(function(){
$("input[name=illegbasinfo]").setselectmoreval(347);
});
這個外掛的巧妙之處在於「用同一個函式遞迴呼叫自己」:每一層 select 都把 vl(層級)加一後交給下一層,並透過 nname 指向下一層的 id,pname 指向上一層。當某層沒有符合 pval 的子資料時,counti 為 0,該層 select 會被移除,聯動自然停止。預設選值的處理則是從最末層 id 一路向上回溯,組出 chckvalarry 陣列,再由各層依索引取值套用。
需要留意的是,這份程式碼建立在 jQuery 1.3.2 時代的 API 上,.size()、.live() 等在後續版本中已被 .length 與 .on() 取代;另外它將狀態暫存在 DOM 元素的擴充屬性 sdiv.get(0).t 上,在新版 jQuery 中更建議改用 .data() 存取。