DIV CSS 佈局教程網

兩個 select 之間的 option 搬移:自製 jQuery 外掛
編輯:JQuery特效代碼     

「把左邊選好的項目移到右邊」這種雙清單互動,常見於權限配置、欄位挑選、多選排序等介面。本文示範如何把它包成一個可重複呼叫的 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() + "]))"));
    });
};

關鍵技巧::not(:has(...))

整支外掛最巧妙的地方在這一行:

$("#" + 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,能省下大量手工處理。

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