DIV CSS 佈局教程網

jQuery 雙向列表選擇器(select 原生版)
編輯:JQuery入門技巧     

雙向列表選擇器(有的團隊叫「穿梭框」)在做權限配置、欄位挑選這類需求時非常順手:左邊是候選清單,右邊是已選清單,中間幾顆按鈕負責搬運。本文用兩個原生 select 標籤實作一個可直接複用的版本。

先說清楚取捨:select 方案的優點是程式碼短、無障礙性天生不錯、鍵盤操作免費;缺點是每一列的樣式幾乎無法客製,沒辦法在一列裡塞多欄資訊。如果設計稿要求較高的視覺自由度,就得改用 div 模擬版(另一篇有完整實作)。

核心邏輯

整支腳本包在一個 two_way_list_selector 函式裡,接收一個容器 jQuery 物件,內部自行找出四顆按鈕與兩個 select:

  • .btn_a:把左邊選中的項目加入右邊
  • .btn_b:把右邊選中的項目移回左邊
  • .btn_add_all:全部加入
  • .btn_remove_all:全部移回
var two_way_list_selector = function (o) {
    var obj = o;
    var btn_a = o.find(".btn_a");
    var btn_b = o.find(".btn_b");
    var btn_c = o.find(".btn_remove_all");
    var btn_d = o.find(".btn_add_all");
    var select_a = o.find(".select_a");
    var select_b = o.find(".select_b");

    // 依 data-index 還原原始順序,避免搬來搬去之後順序亂掉
    var option_sort = function (target) {
        target.html(target.find("option").toArray().sort(function (a, b) {
            return parseInt($(a).attr("data-index")) - parseInt($(b).attr("data-index"));
        }));
        target.find("option").unbind("dblclick").dblclick(function () {
            _dblclick($(this));
        });
    };

    // 雙擊單一項目 = 直接搬到對面
    var _dblclick = function (o) {
        var flag = o.parent().attr("class");
        if (flag === "select_a") {
            var a = o.clone(true);
            select_b.append(a);
            o.remove();
            option_sort(select_b);
        } else {
            var a = o.clone(true);
            select_a.append(a);
            o.remove();
            option_sort(select_a);
        }
    };

    obj.find("option").dblclick(function () { _dblclick($(this)); });

    // 加入選中
    btn_a.click(function () {
        var a = select_a.find("option:selected").clone(true);
        if (a.length === 0) { return false; }
        select_b.append(a);
        select_a.find("option:selected").remove();
        option_sort(select_b);
    });

    // 移回選中
    btn_b.click(function () {
        var a = select_b.find("option:selected").clone(true);
        if (a.length === 0) { return false; }
        select_a.append(a);
        select_b.find("option:selected").remove();
        option_sort(select_a);
    });

    // 全部移回
    btn_c.click(function () {
        select_a.append(select_b.find("option"));
        option_sort(select_a);
    });

    // 全部加入
    btn_d.click(function () {
        select_b.append(select_a.find("option"));
        option_sort(select_b);
    });
};

$(document).ready(function () {
    two_way_list_selector($("#two_way_list_selector_a"));
    two_way_list_selector($("#two_way_list_selector_b"));
});

樣式

版面用 float 切三欄:左右各 40%,中間按鈕區 10%。左右兩個 select 都設 multiple 並給固定高度,option 加上分隔線讓每一列看起來像清單。

.two_way_list_selector { width: 100%; height: 250px; }
.two_way_list_selector .select_l,
.two_way_list_selector .select_r {
    width: 40%; height: 250px; float: left; border: 1px solid #CCC;
}
.two_way_list_selector .select_l select,
.two_way_list_selector .select_r select {
    width: 100%; height: 220px; border: none; outline: none;
}
.two_way_list_selector .select_r select { height: 250px; }
.two_way_list_selector select option { padding: 10px; border-bottom: 1px solid #ddd; }
.two_way_list_selector select option:last-child { border-bottom: none; }
.two_way_list_selector .select_btn {
    width: 10%; height: 250px; float: left; display: table; text-align: center;
}
.two_way_list_selector .select_btn div {
    height: 250px; display: table-cell; vertical-align: middle;
}
.two_way_list_selector .select_btn div input {
    width: 90%; margin: 1px; text-align: center; font-weight: 100; color: #999;
}

結構

<div id="two_way_list_selector_a" class="two_way_list_selector">
  <div class="select_l">
    <div class="option">名稱</div>
    <select size="5" multiple class="select_a">
      <option value="1" data-index="0">1</option>
      <option value="2" data-index="1">2</option>
      <!-- ... -->
    </select>
  </div>
  <div class="select_btn"><div>
    <input type="button" value=">" class="button btn_a">
    <input type="button" value=">>" class="button btn_add_all">
    <input type="button" value="<<" class="button btn_remove_all">
    <input type="button" value="<" class="button btn_b">
  </div></div>
  <div class="select_r">
    <select size="5" multiple class="select_b"></select>
  </div>
</div>

要注意的是 data-index 這個自訂屬性:搬移項目時用的是 clone(true),屬性會一併複製過去,所以排序函式永遠知道每個項目原本排第幾名。少了它,使用者來回搬幾次之後右邊的順序就會變得毫無邏輯。另外,若要取值,直接 $(".select_b").val() 就能拿到已選項目,送表單時記得加上 multiple 並用 [] 命名。

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