結合 jQuery UI Sortable 前端拖拽與 AJAX 後端持久化,構建完整的可視化排序功能。涵蓋初始化、順序序列化、伺服器端點設計、樂觀 UI 更新、錯誤回滾。
<ul id="sortable-list">
<li data-id="10">項目 A</li>
<li data-id="20">項目 B</li>
<li data-id="30">項目 C</li>
</ul>
<button id="save-order" disabled>儲存順序</button>
<script>
$('#sortable-list').sortable({
axis: 'y',
handle: '.drag-handle', // 可選:限制手柄
placeholder: 'sortable-placeholder',
forcePlaceholderSize: true,
tolerance: 'pointer',
update: function(e, ui) {
// 順序已變更,啟用儲存按鈕或自動送出
$('#save-order').prop('disabled', false);
}
});
$('#save-order').on('click', function() {
const $btn = $(this).prop('disabled', true).text('儲存中...');
const order = $('#sortable-list').sortable('toArray', { attribute: 'data-id' });
// order = ['10', '20', '30']
$.ajax({
url: '/api/sort',
method: 'POST',
contentType: 'application/json',
data: JSON.stringify({ ids: order }),
success: function(res) {
$btn.text('已儲存').removeClass('btn-danger').addClass('btn-success');
setTimeout(() => $btn.text('儲存順序').removeClass('btn-success').prop('disabled', true), 2000);
},
error: function(xhr) {
$btn.text('失敗,重試').addClass('btn-danger').prop('disabled', false);
// 可選:回滾到先前順序
// $('#sortable-list').sortable('cancel');
}
});
});
</script>
# POST /api/sort
# Request: { "ids": [30, 10, 20] }
# Response: { "success": true }
# 交易性更新 (避免競態)
BEGIN;
UPDATE items SET sort_order = CASE id
WHEN 30 THEN 1 WHEN 10 THEN 2 WHEN 20 THEN 3 END
WHERE id IN (30,10,20);
COMMIT;
// 前端攜帶版本號
const version = $('#sortable-list').data('version');
$.ajax({ ..., data: JSON.stringify({ ids: order, version }) });
// 後端
UPDATE items SET sort_order = ..., version = version + 1
WHERE id IN (...) AND version = ?; -- 版本不匹配則失敗
// 失敗回傳 409 Conflict,前端重新載入最新順序
jquery-ui-accessible 或改用 SortableJS (原生支援鍵盤)。jQuery UI 已停止維護。新專案推薦 SortableJS:
import Sortable from 'sortablejs';
Sortable.create(document.getElementById('sortable-list'), {
animation: 150,
handle: '.drag-handle',
onEnd: evt => {
const order = Array.from(evt.to.children).map(el => el.dataset.id);
saveOrder(order);
}
});
SortableJS 體積小、無依賴、支援觸控/鍵盤/多欄/樹狀,是現代拖拽排序的首選。