萬盛學電腦網

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

jQuery 透過連結刪除表格列:AJAX 非同步刪除與 DOM 即時更新完整範例

場景

資料列表頁,每列提供「刪除」連結,點擊後彈出確認 → AJAX 刪除後端資料 → 成功則移除前端對應 ``,無需重新整理頁面。

前端 JSP/HTML 結構

<table id="dataTable">
  <thead>
    <tr><th>ID</th><th>名稱</th><th>樓層</th><th>號碼</th><th>電話</th><th>操作</th></tr>
  </thead>
  <tbody>
    <c:forEach items="${owners}" var="owner">
    <tr data-id="${owner.id}">
      <td>${owner.id}</td>
      <td>${owner.name}</td>
      <td>${owner.floor}</td>
      <td>${owner.number}</td>
      <td>${owner.telephone}</td>
      <td class="actions">
        <a href="addOwner.jsp?id=${owner.id}">編輯</a> |
        <a href="javascript:void(0)" class="delete-btn" data-id="${owner.id}">刪除</a>
      </td>
    </tr>
    </c:forEach>
  </tbody>
</table>

jQuery 事件代理 + AJAX 刪除

<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
<script>
$(function () {
  // 事件代理:綁定在 tbody,動態新增列也生效
  $('#dataTable tbody').on('click', '.delete-btn', function (e) {
    e.preventDefault();
    const $btn = $(this);
    const id = $btn.data('id'); // 取得 data-id
    const $row = $btn.closest('tr'); // 找到父列

    if (!confirm(`確定刪除 ID ${id} 嗎?`)) return;

    // 視覺回饋:禁用按鈕、顯示載入中
    $btn.text('刪除中...').prop('disabled', true);

    $.post('deleteOwner!deleteOwner', { id }, function (resp) {
      // 假設後端回傳 { success: true } 或純文字 "success"
      const ok = (typeof resp === 'object' ? resp.success : resp === 'success');
      if (ok) {
        alert('刪除成功!');
        $row.fadeOut(300, function () { $(this).remove(); }); // 動畫移除
      } else {
        alert('刪除失敗:' + (resp.message || '未知錯誤'));
        $btn.text('刪除').prop('disabled', false);
      }
    }).fail(function (xhr) {
      alert('網路錯誤:' + xhr.status);
      $btn.text('刪除').prop('disabled', false);
    });
  });
});
</script>

關鍵技術點

  1. 事件代理 .on('click', '.delete-btn', ...):效能優於逐列綁定,支援動態新增列。
  2. data-id 屬性:乾淨分離資料與行為,避免內聯 onclick="deleteOwner('...', this)" 的字串拼接錯誤。
  3. closest('tr'):可靠向上尋找父列,不受巢狀結構影響。
  4. fadeOut + remove:平滑動畫移除,提升體驗。
  5. 按鈕狀態管理:防止重複點擊,失敗時恢復。

後端介面約定(建議 RESTful JSON)

// Request: POST /api/owners/{id}  或  /deleteOwner
// Body: { "id": "123" } 或 form-data id=123

// Response 成功
{ "success": true, "message": "已刪除" }

// Response 失敗
{ "success": false, "message": "資料不存在或已被引用" }

常見錯誤與修正

錯誤現象原因修正
obj is not defined / this 錯誤 內聯 onclick="deleteOwner(id, this)" 中 this 指向 window 改用事件代理 + data-id,或 onclick="deleteOwner(id, event)" 取 event.target
jQuery 物件包裝錯誤 var o = obj; o.parents(...) → obj 為 DOM 元素 var o = $(obj); 或直接 $(this)
刪除後列表未更新 未在 success 回呼移除 DOM 確認 $row.remove() 在 AJAX 成功後執行
中文參數亂碼 未設定 contentType: application/x-www-form-urlencoded; charset=UTF-8 頁面 ``、後端 `<%@ page pageEncoding="UTF-8"%>`、Tomcat `URIEncoding="UTF-8"`

擴充:批次刪除、軟刪除、撤銷

  • 批次:核取方塊全選 → 收集 IDs 陣列 → 單一 API 呼叫。
  • 軟刪除:後端只更新 deleted_at,前端同步隱藏列,提供「還原」按鈕。
  • 撤銷:前端暫存被刪除列資料,顯示 Toast 含「撤銷」按鈕,限時 5 秒呼叫恢復 API。

採用「事件代理 + data-* 屬性 + AJAX + 動畫移除」模式,能建構出健壯、優雅的列表刪除交互。

copyright © 萬盛學電腦網 all rights reserved