萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery UI Sortable 實作拖拽排序並同步更新後端:完整範例

結合 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>

後端 API 設計建議

# 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,前端重新載入最新順序

無障礙與行動裝置支援

  • 鍵盤操作:Sortable 本身不支援,需搭配 jquery-ui-accessible 或改用 SortableJS (原生支援鍵盤)。
  • 觸控裝置:jQuery UI Touch Punch 補丁或改用 SortableJS (原生觸控)。
  • 螢幕閱讀器:動態更新 `aria-posinset`、`aria-setsize`。

現代化遷移建議

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 體積小、無依賴、支援觸控/鍵盤/多欄/樹狀,是現代拖拽排序的首選。

copyright © 萬盛學電腦網 all rights reserved