DIV CSS 佈局教程網

基於 jQuery 的多級聯動下拉選單外掛實作與下載學習
編輯:JQuery特效代碼     

本文分享一個可遞迴生成任意層級的聯動下拉選單外掛 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);

使用文件(help.html 節錄)

方法名: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() 存取。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved