上一篇介紹了頁面的網址收藏夾功能與記錄排序,那篇用的是「上移/下移」按鈕。功能沒問題,但有同行讀者提醒:直接拖曳會更方便。於是研究了列表拖動排序的做法,本篇記錄如何利用 Sortable 這個開源 JS 組件,把它應用在收藏夾排序上。
收藏夾的存在是為了讓使用者快速進入常用功能。隨著記錄變多,合理的排序就變得必要。
原本的排序介面如下:

核心邏輯是調整當前記錄與相鄰記錄的排序值:
/// <summary> /// 更新向上或者向下的順序 /// </summary> /// <param name="id">記錄的ID</param> /// <param name="moveUp">往上,還是往下移動,往上則為true</param> /// <returns></returns> public bool UpDown(string id, bool moveUp) { //設置排序的規則 bool IsDescending = true; bool result = false; WebFavoriteInfo info = FindByID(id); if (info != null) { //構建查詢的條件 string condition = ""; if (IsDescending) { condition = string.Format("Seq {0} {1}", moveUp ? ">" : "<", info.Seq); } else { condition = string.Format("Seq {0} {1}", moveUp ? "<" : ">", info.Seq); } var list = baseDal.Find(condition); decimal newSeq = 0M; switch (list.Count) { case 0: newSeq = info.Seq;//已在頂部或者底部,順序默認不變 break; case 1: //上面或者下面有一個記錄 if (IsDescending) { newSeq = moveUp ? (list[0].Seq + 1M) : (list[0].Seq - 1M); } else { newSeq = !moveUp ? (list[0].Seq + 1M) : (list[0].Seq - 1M); } break; case 2: //中間區域,取平均值 newSeq = (list[0].Seq + list[1].Seq) / 2M; break; default: //多於兩個的情況 if (moveUp) { newSeq = (list[list.Count - 2].Seq + list[list.Count - 1].Seq) / 2M; } else { newSeq = (list[0].Seq + list[1].Seq) / 2M; } break; } //統一修改順序 info.Seq = newSeq; result = Update(info, info.ID); } return result; }
思路是:先判斷目前位置,再抓出排序在它上面或下面的記錄。0 條代表已在頂或底,順序不動;1 條就在該值上加減一個數字;2 條以上則取最近兩筆的平均值。用平均值而非固定間距,的好處是無論插入多少次都不容易撞號。
按鈕能用,但拖曳顯然更直觀。我找到 Sortable 這個組件,在 GitHub 上評價不錯,使用門檻也低:
<ul id="items"> <li>item 1</li> <li>item 2</li> <li>item 3</li> </ul> var el = document.getElementById('items'); var sortable = new Sortable(el);
整合之後的實際畫面:

列表仍採用分頁,以維持檢索效率:
<div class="portlet-body flip-scroll"> <div class="portlet-body"> <div> <span>每頁顯示</span> <select id="rows" onchange="ChangeRows()"> <option>10</option> <option selected>50</option> <option>100</option> <option>1000</option> </select> <span>條記錄</span> <span>共有記錄:</span><span id='totalCount' class="label label-success">0</span>條,總頁數:<span id='totalPageCount' class="label label-success">0</span>頁。 </div> <hr /> <div id="grid_body" class='list-group'></div> <div class="paging-toolbar"> <ul id='grid_paging'></ul> </div> </div> </div>
每筆記錄的結構:
<div class="list-group-item"> <span class="glyphicon glyphicon-move" aria-hidden="true"></span> <a class="btn btn-sm blue" id="e1f462c6-c749-4258-836f-e13ee8c8acd7" href="https://localhost:2251/User/Index?tid=2744DBF5-A648-47C1-9E9A-D8B405884389">系統用戶信息</a> <i class="js-remove">✖</i> </div>
Sortable 提供了 onUpdate 事件,正好用來在順序變動後送出:
var grid_body = document.getElementById('grid_body'); new Sortable(grid_body, { handle: '.glyphicon-move', filter: ".js-remove", animation: 150, onUpdate: function (/**Event*/evt) { var list = [];//構造集合對象 $('.list-group div a').each(function (i, item) { list.push({ 'Text': item.text, 'Value': item.href }); }); var url = "/WebFavorite/EditFavorite"; var postData = { list: list }; $.post(url, postData, function (json) { var data = $.parseJSON(json); if (data.Success) { //showTips("操作成功"); Refresh();//刷新頁面數據 } else { showTips(data.ErrorMessage); } }); }, });
這裡有兩個參數值得留意:handle 限定只能從那個移動圖示下手拖,避免誤觸連結;filter 則把刪除按鈕排除在拖曳範圍外。
後端收到整份清單後統一更新——先刪舊記錄,再依序寫入並賦予遞減的排序值:
/// <summary> /// 編輯記錄列表 /// </summary> /// <param name="list">記錄列表</param> /// <returns></returns> [HttpPost] public ActionResult EditFavorite(List<CListItem> list) { CommonResult result = new CommonResult(); var userid = CurrentUser.ID; DbTransaction trans = BLLFactory<WebFavorite>.Instance.CreateTransaction(); if (trans != null) { try { //先刪除就記錄 var condition = string.Format("Creator='{0}'", userid); BLLFactory<WebFavorite>.Instance.DeleteByCondition(condition, trans); //逐條添加記錄 int i = list.Count; foreach (CListItem item in list) { WebFavoriteInfo info = new WebFavoriteInfo(); info.Title = item.Text; info.Url = item.Value; info.Seq = i--; info.Creator = CurrentUser.ID.ToString(); BLLFactory<WebFavorite>.Instance.Insert(info, trans); } trans.Commit(); result.Success = true; } catch(Exception ex) { result.ErrorMessage = ex.Message; trans.Rollback(); LogHelper.Error(ex); } } return ToJsonContent(result); }
整段包在交易裡,失敗就回滾,不會出現「刪掉了卻沒寫回去」的殘局。Sortable 這類組件用得好,能明顯改善操作體驗,值得在實戰中多加利用。