DIV CSS 佈局教程網

用 jQuery 實作 listbox 項目搬移並依屬性排序
編輯:JQuery特效代碼     

要讓使用者從一長串清單中挑選項目,兩個並排的 listbox 加上搬移按鈕是相當直覺的介面。若再加上「搬移後自動依某個欄位重新排序」,實用性會更高。本文以水果清單為例,示範完整流程。

一、頁面 HTML

<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>

二、後端繫結資料(C#)

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 的自訂屬性,前端搬移時必須一併帶走,否則排序資訊就斷了。實務上這個值通常來自資料庫的排序欄位。

三、搬移與排序的 jQuery 邏輯

// 搬移項目
// 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 讓項目可拖曳排序。

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