萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML 腳本教學

HTML5 Drag & Drop 實現表格拖拽排序:完整代碼與原理解析

原生 HTML5 Drag & Drop API 結合 JS 可實現表格行/子表格的可視化拖拽重排,無需第三方庫。本文還原經典實現邏輯並修正兼容性問題。

核心 API

  • draggable="true":元素可拖拽。
  • 事件:dragstart、drag、dragenter、dragover、dragleave、drop、dragend。
  • dataTransfer.setData/getData:傳遞標識符 (如行 ID)。

完整實現 (現代化重寫)

<style>
  .drag-table { border-collapse:collapse; margin-bottom:10px; width:100%; }
  .drag-handle { cursor:grab; background:#e5eef9; color:#7787cc; font-weight:bold; padding:5px; }
  .drag-over { background:#fff3cd; }
  .drag-ghost { opacity:0.7; border:1px solid #000; position:absolute; pointer-events:none; z-index:9999; }
</style>

<table id="parentTable" class="drag-table">
  <tr><td valign="top">
    <table class="drag-table"><tr><td class="drag-handle" draggable="true" data-id="t1">表格 1</td></tr></table>
    <table class="drag-table"><tr><td class="drag-handle" draggable="true" data-id="t2">表格 2</td></tr></table>
    <table class="drag-table">
      <tr><td class="drag-handle" draggable="true" data-id="t3">表格 3 (含子表)</td></tr>
      <tr><td>
        <table><tr><td>a</td><td>b</td><td>c</td></tr><tr><td>d</td><td>e</td><td>f</td></tr></table>
      </td></tr>
    </table>
  </td></tr>
</table>

<script>
const parentTable = document.getElementById('parentTable');
let draggedEl = null, ghostEl = null;

document.querySelectorAll('.drag-handle').forEach(handle => {
  handle.addEventListener('dragstart', e => {
    draggedEl = handle.closest('table.drag-table');
    e.dataTransfer.setData('text/plain', handle.dataset.id);
    e.dataTransfer.effectAllowed = 'move';
    // 創建幽靈元素
    ghostEl = draggedEl.cloneNode(true);
    ghostEl.classList.add('drag-ghost');
    ghostEl.style.width = draggedEl.offsetWidth + 'px';
    ghostEl.style.height = draggedEl.offsetHeight + 'px';
    document.body.appendChild(ghostEl);
    e.dataTransfer.setDragImage(ghostEl, 0, 0);
    draggedEl.classList.add('dragging');
  });
  handle.addEventListener('dragend', () => {
    if (ghostEl) ghostEl.remove();
    if (draggedEl) draggedEl.classList.remove('dragging');
    document.querySelectorAll('.drag-over').forEach(el => el.classList.remove('drag-over'));
    draggedEl = ghostEl = null;
  });
});

parentTable.addEventListener('dragover', e => {
  e.preventDefault(); // 必須防止默認才能 drop
  e.dataTransfer.dropEffect = 'move';
  const targetCell = e.target.closest('td');
  if (targetCell) {
    document.querySelectorAll('.drag-over').forEach(el => el.classList.remove('drag-over'));
    targetCell.classList.add('drag-over');
    // 移動幽靈元素跟隨滑鼠
    if (ghostEl) {
      ghostEl.style.left = (e.clientX + 10) + 'px';
      ghostEl.style.top = (e.clientY + 10) + 'px';
    }
  }
});

parentTable.addEventListener('drop', e => {
  e.preventDefault();
  const targetCell = e.target.closest('td');
  if (targetCell && draggedEl && targetCell !== draggedEl.querySelector('.drag-handle')) {
    // 將被拖拽表格移動到目標單元格內 (或插入到子表前)
    const targetTable = targetCell.closest('table.drag-table');
    if (targetTable && targetTable !== draggedEl) {
      targetCell.parentNode.insertBefore(draggedEl, targetCell.nextSibling);
    }
  }
  document.querySelectorAll('.drag-over').forEach(el => el.classList.remove('drag-over'));
});
</script>

關鍵點解析

  1. dragstart 記錄被拖拽元素、設置拖拽圖像 (自定義 ghost 解決跨瀏覽器預覽差異)。
  2. dragover **必須** `e.preventDefault()` 才允許 `drop`。
  3. dataTransfer.setDragImage 只接受已在 DOM 中的元素,故先 `appendChild` 再設置,結束後移除。
  4. 判定插入位置:用 `closest('td')` 找到目標單元格,`insertBefore` 實現重排。
  5. 樣式反饋:`.drag-over` 高亮目標區,`.dragging` 半透明源元素。

避坑指南

  • IE/Edge 早期不支援 `setDragImage`,需回退默認鬼影。
  • 輸入框、按鈕等可聚焦元素在拖拽時可能干扰,建議只在 `.drag-handle` 上綁定 `draggable`。
  • 觸屏設備原生 DnD 不工作,需引入 touch-dnd polyfill 或改用 SortableJS。
  • 大量數據建議虛擬列表 + SortableJS (Web Workers) 避免 DOM 操作卡頓。
copyright © 萬盛學電腦網 all rights reserved