使用 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 | 說明 |
|---|---|
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}`) |
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。