「左側候選清單、右側已選清單」這種雙欄穿梭框是很常見的表單互動。用 jQuery 實作相當直觀:選中項目後建立新的 option 附加到目標 select,再把原項目移除即可。
// 把選中的移動到右邊
function moveToRight(select1, select2) {
$('#' + select1 + ' option:selected').each(function() {
$("<option value='" + $(this).val() + "'>" + $(this).text() + "</option>")
.appendTo("#" + select2);
$(this).remove();
});
}
// 把全部移動到右邊
function moveAllToRight(select1, select2) {
$('#' + select1 + ' option').each(function() {
$("<option value='" + $(this).val() + "'>" + $(this).text() + "</option>")
.appendTo("#" + select2);
$(this).remove();
});
}
// 把選中的移動到左邊
function moveToLeft(select1, select2) {
$('#' + select2 + ' option:selected').each(function() {
$("<option value='" + $(this).val() + "'>" + $(this).text() + "</option>")
.appendTo("#" + select1);
$(this).remove();
});
}
// 把全部移動到左邊
function moveAllToLeft(select1, select2) {
$('#' + select2 + ' option').each(function() {
$("<option value='" + $(this).val() + "'>" + $(this).text() + "</option>")
.appendTo("#" + select1);
$(this).remove();
});
}
除了按鈕,也可以讓使用者雙擊某個選項直接把它送到另一邊:
$('#sel2').bind('dblclick', function() {
moveToRight('sel2', 'sel3');
});
$('#sel3').bind('dblclick', function() {
moveToLeft('sel2', 'sel3');
});
其實不需要複製整個 option 節點。DOM 天生支援節點移動——把既有節點 append 到新位置,它會自動從原處移走:
function moveSelected(from, to) {
$(from).find('option:selected').appendTo(to);
}
function moveAll(from, to) {
$(from).find('option').appendTo(to);
}
// 使用
$('#btnRight').on('click', function() {
moveSelected('#sel2', '#sel3');
});
$('#sel3').on('dblclick', function() {
moveSelected('#sel3', '#sel2');
});
這樣寫有幾個好處:不需要手動 remove、value 與 text 完全不會出錯、也省下了建立新元素的開銷。
這個功能最常出問題的地方不在移動本身,而在表單送出:
示範一下送出前的處理:
$('form').on('submit', function() {
$('#sel2').prop('disabled', true); // 左側不參與送出
});
實務上穿梭框通常還需要「上移、下移」來調整已選項目的順序:
function moveUp(select) {
$(select).find('option:selected').each(function() {
var $prev = $(this).prev();
if ($prev.length) {
$(this).insertBefore($prev);
}
});
}
function moveDown(select) {
$(select).find('option:selected').each(function() {
var $next = $(this).next();
if ($next.length) {
$(this).insertAfter($next);
}
});
}
最後要說的是,.bind() 已於 jQuery 3.0 標記為棄用,新程式碼請統一改用 .on();option:selected 這種寫法也可以寫成 option:checked,兩者效果相同。