省/市/區這類多層級下拉選單,上層一改、下層就跟著重載,是很常見的表單互動。與其每頁重寫一次,不如包成一個可重複呼叫的 jQuery 插件。
先講清楚介面,後面才不會亂:
$(來源_select).autoSelect(目標_select, 請求網址)<select> 的 name 屬性與被選中 <option> 的 value{ value: option的值, text: 顯示文字 }(function($) {
$.fn.extend({
autoSelect: function(dest, url) {
return this.each(function() {
$.SelectChange($(this), $(dest), url);
});
}
});
重置的作用是「回到初始狀態」:清空後代選項,再放回原本的第一個 option 作為佔位項。
// 重置下拉選單
$.SelectReset = function(target) {
if (target != null) {
$.SelectReset(target.data("nextSelect")); // 沿著聯動鏈一路清下去
target.empty();
target.append(target.data("defaultOpt"));
}
};
// 依 JSON 資料填入 option
$.SelectLoad = function(target, data) {
$.each(data, function(index, content) {
var option = $("<option></option>")
.attr("value", content.value)
.text(content.text);
target.append(option);
});
};
$.SelectChange = function(target, dest, url) {
// 記下「下一層是誰」,形成聯動鏈
target.data("nextSelect", dest);
// 記住每個 select 的預設選項(第一個 option)
if (target.data("defaultOpt") == null)
target.data("defaultOpt", target.children().first());
dest.data("defaultOpt", dest.children().first());
$(document).ready(function() {
target.change(function(event) {
var _target = event.target || window.event.srcElement;
if (_target.value != target.data("defaultOpt").attr("value")) {
$.getJSON(url, {
"name": _target.name,
"value": _target.value
}, function(data, status) {
if (status == "success") {
$.SelectReset(target.data("nextSelect"));
$.SelectLoad(target.data("nextSelect"), data);
}
});
} else {
// 使用者改回預設項,下游直接清空
$.SelectReset(target.data("nextSelect"));
}
});
});
};
})(jQuery);
第一,data() 拿來存「下一層節點」與「預設選項」,等於把關聯資訊掛在元素身上,不必另外維護一張對照表。第二,SelectReset 用遞迴沿著鏈往下清,三層、四層都適用,只要每一層都有正確的 nextSelect。第三,把「使用者選回預設值」當成一個獨立分支處理,可以避免下游殘留髒資料。
實務上要留意的是 $.getJSON 的快取問題,若後端回應可能被快取,記得加上時間戳或關閉快取,否則切換上層選項時可能拿到舊資料。