本文以完整篇幅介紹 jQuery UI sortable 的拖動排序功能,包含事件回呼參數、各項配置選項、事件與方法,並附上排序後保存到資料庫的實作。
所有的事件回呼函數都有兩個參數:event 和 ui,分別是瀏覽器自有 event 對象與經過封裝的 ui 對象:
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 在元素沒改變位置時也會執行,需依實際需求權衡。