DIV CSS 佈局教程網

jQuery 拖曳排序 Li 與 Table:後台列表排序的完整實作
編輯:JQuery特效代碼     

後台的文章列表、廣告排序、首頁推薦位,都需要「拖一下就能換順序」。實作靠 jQuery UI 的 sortable:它負責拖曳與 DOM 重排,我們只要把它整理後的 id 順序丟回伺服器保存即可。

一、需要的資源

除了 jQuery 本體,還要載入 jQuery UI 的兩個檔案:ui.core.js(提供 widget 工廠與滑鼠互動基礎)與 ui.sortable.js(排序元件本身)。兩者有相依關係,順序不能顛倒。

二、啟動排序

<script src="Scripts/jquery-1.4.1.js" type="text/javascript"></script>
<script src="Scripts/ui.core.js" type="text/javascript"></script>
<script src="Scripts/ui.sortable.js" type="text/javascript"></script>

<script type="text/javascript">
$(function () {
    $('.sortable').sortable({ cursor: 'move' });
});
</script>

cursor: 'move' 讓滑鼠移到可排序項目上時變成移動游標,給使用者一個明確的線索。加上這一行,列表就能拖了。

三、取得順序並存檔

function getsortresult(prefix, aftfix) {
    var flag = document.getElementById(prefix + "_sortable_" + aftfix);
    if (flag) {
        var result = $("#" + prefix + "_sortable_" + aftfix).sortable('toArray');
        $(":button").attr("disabled", "disabled");
        $(":submit").attr("disabled", "disabled");
        $("#delay_" + prefix + "_" + aftfix).show();
        $("#normal_" + prefix + "_" + aftfix).hide();

        $.ajax({
            url: "PhoneArticleListPage_2.aspx?word=" + result,
            cache: false,
            success: function (html) {
                $("#delay_" + prefix + "_" + aftfix).hide();
                $("#normal_" + prefix + "_" + aftfix).show();
                $(":button").removeAttr("disabled");
                $(":submit").removeAttr("disabled");
            }
        });
        alert("手機文章列表排列順序保存成功!");
    } else {
        alert("沒有需要排序的手機文章列表!");
        return false;
    }
}

sortable('toArray') 是關鍵。它會依目前 DOM 順序,把每個項目的 id 屬性收集成陣列。這也是為什麼每個 <li> 都要有一個結構化的 id:

<ul class="sortable" id="sitelinks_sortable_text">
  <li id="sitelinks_text_96"> ... </li>
  <li id="sitelinks_text_78"> ... </li>
  <li id="sitelinks_text_94"> ... </li>
</ul>

命名慣例是 前綴_群組_流水號。jQuery UI 預設用 -、_ 或 = 作為分隔,並把最後一段當成 id 值;若你的命名規則不同,可在呼叫時傳入自訂的 expression。

四、列表結構

每個 <li> 裡面放一個 table 排版內容,包含勾選框、編輯連結、標題、縮圖與來源網址:

<li id="sitelinks_text_96" style="border:1px solid #bad5f2; background:#f7fbfe;">
  <table style="width:100%; table-layout:fixed; word-wrap:break-word;">
    <tr>
      <td width="30%"><input type="checkbox" name="checkbox" value="96" /></td>
      <td width="70%">
        <a href="javascript:void(0)" onclick="editlink('sitelinks','text','96')">[編輯]</a>
      </td>
    </tr>
    <tr><td><b>文章標題:</b></td><td>……</td></tr>
    <tr><td><b>列表圖片:</b></td><td><img src="..." width="100" height="50" /></td></tr>
    <tr><td><b>文章URL:</b></td><td><a href="...">……</a></td></tr>
  </table>
</li>

table-layout:fixed 搭配 word-wrap:break-word 是必要的——標題長度不一,不固定的話每列的欄寬會被最長的那一列撐開,看起來歪七扭八。

五、樣式要點

.sortable { margin:0; padding:0; }
.sortable li { margin:3px 8px 3px 0; float:left; width:250px; height:170px; }

float:left 讓項目橫向並排;寬高固定則讓每張卡片尺寸一致。原專案另外附了一份完整的後台通用樣式(表格、按鈕、分頁、Tab 等),這裡不再贅述,實作排序時真正相關的就是上面三行。

六、其他配套功能

批量刪除:走訪 getElementsByName("checkbox"),把勾選項的 value 用逗號串起來,丟到 ?Del_Id= 由後端處理。

編輯:用 editWidget() 開啟編輯頁,把 id 帶進 query string。

等待提示:存檔期間把 #normal_... 換成 #delay_...(通常是 loading 動畫),同時 disable 所有按鈕,避免重複送出。

七、這個版本該修正的地方

原始碼是 jQuery 1.4 年代的寫法,搬進新專案前建議處理幾點:

把順序放進 POST body。用 query string 傳 ?word=id,id,id 有兩個問題:URL 長度有上限,列表一長就會被截斷;順序資料出現在網址與伺服器日誌裡也不理想。改用 $.ajax({ type:"POST", data:{ order: result } }) 更穩妥。

成功提示要放在 callback 裡。原章的 alert("保存成功") 寫在 $.ajax() 之後,請求還沒回來就跳了,失敗時也會顯示成功。應該移到 success 內,並補上 error 處理。

jQuery UI 版本要更新。1.7.1 已非常老舊,新版 jQuery 跑不動。請改用當前支援的 jQuery 與 jQuery UI 3.x/4.x。

拖曳排序對鍵盤使用者不友善。jQuery UI 的 sortable 預設無法用鍵盤操作。若有无障碍要求,需另外提供「上移/下移」按鈕作為替代路徑。

整體而言,這套做法到今日依然適用:sortable 負責前端重排,toArray() 負責把順序序列化,後端只需要一個「依傳入順序更新排序欄位」的介面。前後端職責分得很乾淨,這也是它值得參考的原因。

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