DIV CSS 佈局教程網

jQuery sortable 拖動排序方法詳解
編輯:JavaScript綜合知識     

本文以完整篇幅介紹 jQuery UI sortable 的拖動排序功能,包含事件回呼參數、各項配置選項、事件與方法,並附上排序後保存到資料庫的實作。

事件回呼的 ui 對象

所有的事件回呼函數都有兩個參數:event 和 ui,分別是瀏覽器自有 event 對象與經過封裝的 ui 對象:

  • ui.helper - 表示 sortable 元素的 jQuery 對象,通常是當前元素的克隆對象
  • ui.position - 相對於當前對象,鼠標的坐標值對象 {top, left}
  • ui.offset - 相對於當前頁面,鼠標的坐標值對象 {top, left}
  • ui.item - 表示當前拖拽的元素
  • ui.placeholder - 占位符(如果有定義的話)
  • ui.sender - 當前拖拽元素的所屬 sortable 對象(僅當元素從另一個 sortable 傳遞過來時有用)

常用參數

  • appendTo(預設 'parent'):定義 helper 在拖動時掛載的位置
  • axis(預設 false):限制只能橫向('x')或縱向('y')拖動
  • cancel(預設 ':input,button'):阻止排序動作在匹配元素上發生
  • connectWith(預設 false):允許連接另一個 sortable 對象,可跨列表拖拽
  • containment(預設 false):約束排序只能在一定範圍內發生
  • cursor(預設 'auto'):定義開始排序時鼠標的樣式
  • delay(預設 0):延遲多久才激活排序,可防止誤點
  • distance(預設 1):至少拖動多少像素才觸發排序
  • dropOnEmpty(預設 true):是否允許拖拽到空的 sortable 對象
  • grid(預設 false):把元素視為格子處理,每次按 [x, y] 移動
  • handle(預設 false):限制只能在 item 內某元素上開始排序
  • helper(預設 'original'):'original' 或 'clone'
  • items(預設 '> *'):指定哪些元素可拖拽排序
  • opacity(預設 false):拖動時 helper 的透明度
  • revert(預設 false):返回新位置時是否有動畫效果
  • scroll(預設 true):拖到頁面邊緣時是否自動滾動
  • tolerance(預設 'intersect'):'intersect'(重疊 50%)或 'pointer'(鼠標重疊)
  • zIndex(預設 1000):排序時元素的 z-index

常用事件

start(開始)、sort(排序中)、change(坐標改變)、beforeStop(結束前)、stop(結束)、update(結束且坐標改變)、receive(接收其他 sortable 的元素)、over(拖入)、out(拖出)、activate 與 deactivate(連接對象開始/結束排序)。事件既可透過參數定義,也能用 bind('sortstart', ...) 綁定。

常用方法

destroy(移除拖拽功能)、disable/enable(禁用/啟用)、option(獲取或設置參數)、serialize(序列化 id)、toArray(取得 id 陣列)、refresh/refreshPositions(重新整理排序與坐標)、cancel(取消排序改變)。

排序後保存到資料庫

排序後的保存有兩種方式:一是 cookie,二是資料庫配置文件。以下是資料庫部分的實作:

$(function () {
  var show = $(".loader");
  var listleft = $("div[id = 'column_left']");
  var listcenter = $("div[id = 'column_center']");
  var listright = $("div[id = 'column_right']");

  $(".column").sortable({
    opacity: 0.5,       // 拖動的透明度
    revert: true,       // 緩沖效果
    cursor: 'move',     // 拖動時鼠標樣式
    connectWith: ".column",
    stop: function () {
      var new_order_left = [];   // 左欄布局
      var new_order_center = []; // 中欄布局
      var new_order_right = [];  // 右欄布局
      listleft.children(".portlet").each(function () {
        new_order_left.push(this.title);
      });
      listcenter.children(".portlet").each(function () {
        new_order_center.push(this.title);
      });
      listright.children(".portlet").each(function () {
        new_order_right.push(this.title);
      });
      $.ajax({
        type: "post",
        url: jsonUrl, // 服務端處理程序
        data: {
          leftid: new_order_left.join(','),
          centerid: new_order_center.join(','),
          rightid: new_order_right.join(',')
        },
        success: function (msg) {
          show.html("");
        }
      });
    }
  });
});

透過 stop 事件收集三欄各自的排序結果,再用 AJAX 提交到後端保存。注意作者特别提醒:用 update 會導致結果執行兩次浪費資源,改用 stop 較佳,但 stop 在元素沒改變位置時也會執行,需依實際需求權衡。

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