萬盛學電腦網

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

jQuery DataTables 刪除行後頁面狀態保持與 Ajax 刷新最佳實踐

問題背景

使用 DataTables 服務端模式 (`serverSide: true`) 時,刪除記錄後需要:
1. 保持在當前頁(不跳回第一頁)
2. 若當前頁刪除後為空,自動跳轉上一頁
3. 保留排序、搜索、分頁狀態

初始化關鍵配置

var table = $('#dataTable').DataTable({
  serverSide: true,           // 服務端模式
  ajax: {
    url: '/api/users',
    type: 'POST',
    data: function(d) {       // 附加額外參數
      d.extraParam = 'value';
    }
  },
  stateSave: true,            // 關鍵:保存狀態到 localStorage (頁碼、排序、搜索)
  stateDuration: 7200,        // 狀態保存 2 小時 (秒)
  pagingType: 'full_numbers',
  dom: '<"top"lfr>rt<"bottom"ip><"clear">',
  columns: [
    { data: 'id', orderable: false },
    { data: 'name' },
    { data: 'email' },
    { data: 'role' },
    { data: 'status' },
    { data: 'createdAt' },
    { data: 'actions', orderable: false, searchable: false, render: renderActions }
  ]
});

刪除操作與狀態恢復邏輯

function deleteUser(userId) {
  if (!confirm('確定刪除該用戶?')) return;
  
  $.ajax({
    url: '/api/users/' + userId,
    type: 'DELETE',
    dataType: 'json',
    success: function(res) {
      if (res.success) {
        toastr.success('刪除成功');
        
        // 核心:獲取當前頁信息
        var settings = table.settings()[0];
        var start = settings._iDisplayStart;      // 當前頁起始記錄索引 (0-based)
        var total = settings.fnRecordsDisplay();  // 總記錄數 (過濾後)
        var pageLen = settings._iDisplayLength;   // 每頁條數
        
        // 判斷:刪除後當前頁是否還有數據
        // 當前頁剩餘 = total - start
        // 若剩餘 <= 1 (即刪除前只有 1 條),刪除後當前頁為空
        if (total - start <= 1) {
          if (start > 0) {
            // 有上一頁,翻到上一頁
            table.page('previous').draw(false); // false = 不重置分頁 (但這裡本意是跳頁)
            // 更準確:table.page(table.page() - 1).draw(false);
          }
          // else: 已是第一頁,draw 即可
        }
        
        // 重繪表格 (保持分頁、排序、搜索狀態)
        table.draw(false); // false = 保持當前分頁 (不重置到第一頁)
        
      } else {
        toastr.error(res.message || '刪除失敗');
      }
    },
    error: function(xhr) {
      toastr.error('網絡錯誤:' + xhr.status);
    }
  });
}

關鍵 API 誦解

API說明
table.settings()[0]獲取 DataTables 內部設定對象 (包含 `_iDisplayStart`, `_iDisplayLength` 等私有屬性)
settings.fnRecordsDisplay()獲取過濾後總記錄數
table.page('previous')跳轉到上一頁 (返回 API 實例,鏈式調用)
table.page(pageIndex)跳轉到指定頁碼 (0-based)
table.draw(false)重繪表格,`false` = 保持當前分頁位置 (不重置 `_iDisplayStart`)
stateSave: true自動保存/恢復 `page`、`order`、`search` 到 `localStorage` (鍵: `DataTables_{tableId}`)

常見坑點與修正

  1. `table.draw()` 會重置分頁:必須傳 `false`:`table.draw(false)`。
  2. `stateSave` 衝突:若手動 `table.page()` 後 `draw(false)`,狀態保存可能記錄舊頁碼。解決:手動更新狀態或依賴 `draw(false)` 內部邏輯 (DT 1.10.8+ 已修復)。
  3. 服務端返回總數異常:確保後端刪除成功後返回的 `recordsTotal`/`recordsFiltered` 為最新值。
  4. 多實例 ID 衝突:每個 DataTable 需唯一 `id` 屬性,`stateSave` 鍵名基於此 ID。

完整封裝:可復用刪除函數


function dtDeleteRow(table, rowSelector, deleteUrl, options) {
  var opts = $.extend({
    confirmMsg: '確定刪除?',
    successMsg: '刪除成功',
    errorMsg: '刪除失敗'
  }, options);
  
  $(document).on('click', rowSelector, function(e) {
    e.preventDefault();
    var $btn = $(this);
    var id = $btn.data('id');
    
    if (!confirm(opts.confirmMsg)) return;
    
    $btn.prop('disabled', true).text('刪除中...');
    
    $.ajax({
      url: deleteUrl.replace(':id', id),
      type: 'DELETE',
      dataType: 'json'
    }).done(function(res) {
      if (res.success) {
        toastr.success(opts.successMsg);
        smartRedraw(table);
      } else {
        toastr.error(res.message || opts.errorMsg);
      }
    }).fail(function(xhr) {
      toastr.error(opts.errorMsg + ' (' + xhr.status + ')');
    }).always(function() {
      $btn.prop('disabled', false).text('刪除');
    });
  });
  
  function smartRedraw(dt) {
    var s = dt.settings()[0];
    var start = s._iDisplayStart;
    var total = s.fnRecordsDisplay();
    var len = s._iDisplayLength;
    
    // 當前頁剩餘記錄數 (刪除前)
    var remaining = total - start;
    
    if (remaining <= 1 && start > 0) {
      // 當前頁即將為空且有上一頁
      dt.page('previous').draw(false);
    } else {
      dt.draw(false);
    }
  }
}

// 使用
dtDeleteRow(table, '.btn-delete', '/api/users/:id');

結語

DataTables `stateSave: true` 是保持狀態的基石。刪除後智能判斷頁面是否為空並決定是否翻頁,配合 `draw(false)` 保持分頁,能帶來絲滑的用戶體驗。封裝通用 `dtDeleteRow` 讓專案中所有刪除操作統一標準、零 Bug。

copyright © 萬盛學電腦網 all rights reserved