DIV CSS 佈局教程網

自製 jQuery 外掛 selectToSelect:雙清單穿梭選擇器
編輯:JQuery特效代碼     

網路上四處找不著合適的「雙欄穿梭選擇器」外掛,乾脆自己動手做了一個。它能將候選項與已選項分置左右兩欄,中間配上「全部移入、單項移入、單項移出、全部移出」以及上下排序按鈕,適合大量資料的挑選與排序場景。分享出來,若有人手上有更強大的版本,也歡迎提供。

效果如下:

整個外掛透過 jQuery UI 的 button 樣式美化按鈕,並以 onChange 回呼把最新的已選 ID 串回傳給呼叫端。以下是完整程式碼:

(function($){
    $.fn.selectToSelect = function(options){
        if($.type(options) == "string"){
            var $this = $(this);
            if(options == "getSelectedIds"){
                var ids = "";
                var arr = $("#" + $this.attr("id") + "seReSelect option");
                arr.each(function(i){
                    if(arr.length - 1 == i){
                        ids += $(this).attr("id");
                    }else{
                        ids += $(this).attr("id") + ",";
                    }
                });
                return ids;
            }
            return $this;
        }
        var defaults = {
            size: 10,
            opSelect: [],
            opReSelect: [],
            onChange: function(data){}
        };
        var opts = $.extend(defaults, options);
        return this.each(function(){
            var $this = $(this);
            var str = "<table><tr>";
            // 左欄:候選清單
            str += "<td style='vertical-align: top;'>";
            str += "<select id='" + $this.attr("id") + "seSelect' multiple='multiple' size='" + opts.size + "'>";
            for(var i=0;i<opts.opSelect.length;i++){
                str += "<option id='" + opts.opSelect[i].id + "' value='" + opts.opSelect[i].id + "'>" + opts.opSelect[i].name + "</option>";
            }
            str += "</select></td>";
            // 中欄:穿梭按鈕(全部/單項 移入移出、上下排序)
            // ... 略去中間按鈕組的組字串 ...
            // 右欄:已選清單
            str += "<td style='vertical-align: top;'>";
            str += "<select id='" + $this.attr("id") + "seReSelect' multiple='multiple' size='" + opts.size + "'>";
            for(var i=0;i<opts.opReSelect.length;i++){
                str += "<option id='" + opts.opReSelect[i].id + "' value='" + opts.opReSelect[i].id + "'>" + opts.opReSelect[i].name + "</option>";
            }
            str += "</select></td></tr></table>";
            $this.html(str);
            // 需要 jQuery UI 外掛
            $this.find("button").button();
            // 各按鈕的點擊事件:全部移入、全部移出、單項移入、單項移出、上移、下移
            // 每次操作後呼叫 opts.onChange 回傳最新已選項
        });
    };
})(jQuery);

由於完整程式碼篇幅較長,上面保留了骨架與關鍵片段(左右清單的組字串、jQuery UI 按鈕化、onChange 回呼機制)。呼叫方式如下:

var opSelect1 = [{id:'1',name:'tip1'},{id:'2',name:'tip2'}];
var opReSelect1 = [{id:'3',name:'tip3'},{id:'4',name:'tip4'}];
$("#selectToSelect1").selectToSelect({
    size: 10,
    opSelect: opSelect1,
    opReSelect: opReSelect1,
    onChange: function(options){
        var ids = $("#selectToSelect1").selectToSelect("getSelectedIds");
    }
});

設計上有幾個巧思:以字串參數呼叫時走「取資料」分支,回傳已選 ID 串;傳入物件時則走「初始化」分支,動態組出整個穿梭介面。這種「同一方法兼具 getter 與 setter」的寫法,正是 jQuery 外掛常見的介面設計慣例。你只要傳入兩組 {id, name} 資料,就能立刻得到一個可排序的雙欄選擇器。

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