要讓使用者從一長串清單中挑選項目,兩個並排的 listbox 加上搬移按鈕是相當直覺的介面。若再加上「搬移後自動依某個欄位重新排序」,實用性會更高。本文以水果清單為例,示範完整流程。
<table border="0">
<tr>
<td width="156">全部水果:</td>
<td width="142"></td>
<td width="482">我挑選的:</td>
</tr>
<tr>
<td rowspan="2">
<asp:ListBox SelectionMode="Multiple" ID="listall" Rows="12"
Width="156" runat="server"></asp:ListBox>
</td>
<td height="41" align="center">
<input type="button" id="btnleftmove" value=">>>"
onclick="move('listall','listmy');" /><br /><br />
<input type="button" id="btnrightmove" value="<<<"
onclick="move('listmy','listall');" />
</td>
<td rowspan="2">
<asp:ListBox SelectionMode="Multiple" ID="listmy" Rows="12"
Width="156" runat="server"></asp:ListBox>
</td>
</tr>
</table>
public partial class _Default : System.Web.UI.Page
{
protected void Page_Load(object sender, EventArgs e)
{
if (!IsPostBack)
{
BindData();
}
}
private void BindData()
{
ArrayList list = DataArray();
for (int i = 0; i < list.Count; i++)
{
listall.Items.Add(list[i].ToString());
// 用自訂的 tag 屬性記錄排序欄位
listall.Items[i].Attributes["tag"] = i.ToString();
}
}
private ArrayList DataArray()
{
// 範例資料,此處已預先依中文排序
ArrayList list = new ArrayList();
list.Add("草莓"); list.Add("梨"); list.Add("桔子");
list.Add("芒果"); list.Add("蘋果"); list.Add("香蕉");
return list;
}
}
重點在 Attributes["tag"] 這一行。它把排序用的鍵值存進 option 的自訂屬性,前端搬移時必須一併帶走,否則排序資訊就斷了。實務上這個值通常來自資料庫的排序欄位。
// 搬移項目
// setname: 移出的清單 getname: 移入的清單
function move(setname, getname) {
var size = $("#" + setname + " option").size();
var selsize = $("#" + setname + " option:selected").size();
if (size > 0 && selsize > 0) {
$.each($("#" + setname + " option:selected"), function (id, own) {
var text = $(own).text();
var tag = $(own).attr("tag");
// 把 tag 一起帶過去
$("#" + getname).prepend('<option tag="' + tag + '">' + text + '</option>');
$(own).remove();
$("#" + setname).children("option:first").attr("selected", true);
});
}
// 搬完之後重新排序
$.each($("#" + getname + " option"), function (id, own) {
orderrole(getname);
});
}
// 依 tag 數值排序
function orderrole(listname) {
var size = $("#" + listname + " option").size();
var one = $("#" + listname + " option:first-child");
if (size > 0) {
var text = $(one).text();
var tag = parseInt($(one).attr("tag"));
$.each($(one).nextAll(), function (id, own) {
var nextag = parseInt($(own).attr("tag"));
if (tag > nextag) {
$(one).remove();
$(own).after('<option tag="' + tag + '">' + text + '</option>');
one = $(own).next();
}
});
}
}
move() 的結構很清楚:先確認來源清單有項目且有勾選,再逐一搬移,最後呼叫 orderrole() 重排。
orderrole() 用的是插入排序的思維:取出第一項,與它後面的每一項比較 tag 值;只要發現後者比它小,就把第一項移到那個位置之後,然後繼續往下比。反覆執行直到整列有序。這個做法不需要額外的暫存陣列,直接操作 DOM 就能完成。
要留意的是 $.each($("#"+getname+" option"), ...) 這段外層迴圈有點冗餘——orderrole() 本身已經處理整列,外層再跑一次並不會改變結果,只是多做幾遍無意義的工作。實作時可以直接呼叫一次 orderrole(getname)。
.size() 在 jQuery 3.0 中已被移除,請改用 .length。自訂屬性建議改用 HTML5 的 data-tag 並以 .data("tag") 或 .attr("data-tag") 讀取,語意更清楚也不會與標準屬性混淆。
另外,後端 PostBack 時,前端用 JavaScript 搬移的項目不會自動回傳。ASP.NET Web Forms 中通常需要搭配 HiddenField 記錄選取結果,或在伺服器端重新比對原始清單,這是最容易在整合階段出錯的地方。
若使用者在搬移後還需要調整順序,可考慮在目標清單上加入上下移動按鈕,或整合 jQuery UI 的 sortable 讓項目可拖曳排序。