雙向列表選擇器(有的團隊叫「穿梭框」)在做權限配置、欄位挑選這類需求時非常順手:左邊是候選清單,右邊是已選清單,中間幾顆按鈕負責搬運。本文用兩個原生 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 並用 [] 命名。