「把左邊選好的項目移到右邊」這種雙清單互動,常見於權限配置、欄位挑選、多選排序等介面。本文示範如何把它包成一個可重複呼叫的 jQuery 外掛,並處理「目標清單已有重複值」的邊界情況。
核心是兩個函式,差別在於搬移語意:
jQuery.listTolist(fromid, toid, moveOrAppend, isAll)
move 模式:來源清單中被選中的 option 會被刪除,真正「搬」過去。
append 模式:來源 option 保留不動,只是複製一份到目標清單。
兩種模式都不會新增重複值。isAll 為 true 時處理全部項目,false 時只處理 selected 的項目。
jQuery.list2list(fromid, toid, isAll)
行為等同 move 模式,但有一個差異:當來源 option 的值在目標清單中已存在時,來源那項不會被刪除,避免資料憑空消失。
jQuery.listTolist = function (fromid, toid, moveOrAppend, isAll) {
var mode = moveOrAppend.toLowerCase();
if (mode === "move") {
if (isAll === true) {
$("#" + fromid + " option").each(function () {
// 目標清單不存在同值時才附加
$(this).appendTo(
$("#" + toid + ":not(:has(option[value=" + $(this).val() + "]))"));
});
$("#" + fromid).empty(); // 清空來源
} else {
$("#" + fromid + " option:selected").each(function () {
var val = $(this).val();
$(this).appendTo($("#" + toid + ":not(:has(option[value=" + val + "]))"));
// 若目標清單已有同值,append 不會生效,來源需手動清掉
if ($("#" + fromid + " option[value=" + val + "]").length > 0) {
$("#" + fromid).get(0)
.removeChild($("#" + fromid + " option[value=" + val + "]").get(0));
}
});
}
} else if (mode === "append") {
var sel = isAll === true ? $("#" + fromid + " option")
: $("#" + fromid + " option:selected");
sel.each(function () {
$('<option></option>')
.val($(this).val())
.text($(this).text())
.appendTo($("#" + toid + ":not(:has(option[value=" + $(this).val() + "]))"));
});
}
};
jQuery.list2list = function (fromid, toid, isAll) {
var sel = isAll === true ? $("#" + fromid + " option")
: $("#" + fromid + " option:selected");
sel.each(function () {
$(this).appendTo($("#" + toid + ":not(:has(option[value=" + $(this).val() + "]))"));
});
};
整支外掛最巧妙的地方在這一行:
$("#" + toid + ":not(:has(option[value=" + $(this).val() + "]))")
它讀起來是「目標清單中,不包含這個 value 的 option 的那個 select」。如果目標清單裡已經有相同值,這個選擇器就選不到任何元素,appendTo() 自然什麼也不做——用選擇器就完成了去重,不必額外寫 if 判斷。
而 move 模式之所以還要補一段 removeChild,是因為 appendTo 沒生效時,來源那項會留在原地,若不特別處理就會出現「看似搬移失敗」的錯覺。
// 把 listA 中選取的項目搬到 listB
jQuery.listTolist("listA", "listB", "move", false);
// 把 listA 全部項目複製到 listB(來源保留)
jQuery.listTolist("listA", "listB", "append", true);
// 搬移但保留目標已存在的來源項
jQuery.list2list("listA", "listB", false);
用 option[value=...] 這種未加引號的屬性選擇器,在 jQuery 3.x 中已不再支援,必須改寫成 option[value="..."];若值可能包含空白或特殊字元,還需要進一步跳脫。另外,搬移完的結果若要送出,別忘了表單送出時只會包含 name 相同的欄位——select 被清空後,其 option 自然不會被序列化,這點在設計後端接收邏輯時要留意。
如果搬移後還需要「記住原始順序」或「支援拖曳排序」,建議直接改用 jQuery UI 的 sortable() 搭配 connectWith,能省下大量手工處理。