萬盛學電腦網

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

原生 JS 實現可拖曳排序列表:跨瀏覽器(IE/FF/Chrome)動畫交換位置

核心挑戰:跨瀏覽器事件模型差異

  • IE ≤ 8:`window.event`、`srcElement`、`attachEvent`
  • 現代瀏覽器:`event` 傳參、`target`、`addEventListener`
  • 動畫計時:`setTimeout` 逐幀插值(無 `requestAnimationFrame` 時代)

現代化重寫(ES6 + `requestAnimationFrame` + `Pointer Events`)

<ul id="sortable" class="sortable">
  <li><div class="handle">⋮⋮</div> 項目 1</li>
  <li><div class="handle">⋮⋮</div> 項目 2</li>
  <li><div class="handle">⋮⋮</div> 項目 3</li>
  <li><div class="handle">⋮⋮</div> 項目 4</li>
</ul>

<style>
.sortable { list-style: none; padding: 0; max-width: 400px; }
.sortable li { display: flex; align-items: center; padding: 12px 16px; background: #fff; border: 1px solid #e0e0e0; margin-bottom: 8px; cursor: grab; transition: box-shadow .2s, transform .2s; }
.sortable li.dragging { opacity: .5; box-shadow: 0 8px 24px rgba(0,0,0,.15); cursor: grabbing; }
.sortable li.placeholder { background: #e3f2fd; border: 2px dashed #1976d2; min-height: 48px; }
.handle { margin-right: 12px; color: #999; user-select: none; }
</style>

<script>
class SortableList {
  constructor(listEl, options = {}) {
    this.list = listEl;
    this.handleSel = options.handle || '.handle';
    this.animationMs = options.animation || 200;
    this.items = [...this.list.children];
    this.dragged = null;
    this.placeholder = null;
    this._bind();
  }

  _bind() {
    this.list.addEventListener('pointerdown', e => {
      const handle = e.target.closest(this.handleSel);
      if (!handle) return;
      const item = handle.closest('li');
      if (!item) return;
      this._startDrag(item, e);
    });
  }

  _startDrag(item, e) {
    this.dragged = item;
    item.classList.add('dragging');
    item.style.position = 'relative';
    item.style.zIndex = 1000;

    // 建立佔位元素
    this.placeholder = document.createElement('li');
    this.placeholder.className = 'placeholder';
    this.placeholder.style.height = item.offsetHeight + 'px';
    this.list.insertBefore(this.placeholder, item.nextSibling);

    const startY = e.clientY;
    const startTop = item.offsetTop;

    const onMove = e => {
      const dy = e.clientY - startY;
      item.style.transform = `translateY(${dy}px)`;
      this._checkReorder(item, startTop + dy);
    };
    const onUp = () => {
      document.removeEventListener('pointermove', onMove);
      document.removeEventListener('pointerup', onUp);
      item.classList.remove('dragging');
      item.style.position = '';
      item.style.zIndex = '';
      item.style.transform = '';
      this.list.replaceChild(item, this.placeholder);
      this.placeholder = null;
      this.dragged = null;
      this.items = [...this.list.children];
    };
    document.addEventListener('pointermove', onMove);
    document.addEventListener('pointerup', onUp);
  }

  _checkReorder(dragged, currentTop) {
    const items = this.items.filter(li => li !== dragged);
    for (const item of items) {
      const itemTop = item.offsetTop;
      const itemMid = itemTop + item.offsetHeight / 2;
      if (currentTop < itemMid && dragged.compareDocumentPosition(item) & Node.DOCUMENT_POSITION_FOLLOWING) {
        this.list.insertBefore(dragged, item);
        this.items = [...this.list.children];
        break;
      }
      if (currentTop > itemMid && dragged.compareDocumentPosition(item) & Node.DOCUMENT_POSITION_PRECEDING) {
        this.list.insertBefore(dragged, item.nextSibling);
        this.items = [...this.list.children];
        break;
      }
    }
  }
}

// 初始化
new SortableList(document.getElementById('sortable'));
</script>

關鍵技術點解析

技術說明
`pointerdown/move/up`統一鼠標/觸控/筆事件,無需分開寫 `mousedown`/`touchstart`
`closest()`向上尋找最近符合選擇器的祖先,替代舊式 `while(parent)` 迴圈
`compareDocumentPosition`標準 DOM API 判斷節點前後關係,替代手動索引比較
佔位元素保持列表高度不塌陷,視覺上平滑
`transform: translateY`僅觸發合成器層,不觸發重排,動畫絲滑

進階擴展:SortableJS / @dnd-kit

  • SortableJS:零依賴、支援多列表拖拽、觸控、動畫、插件系統(Vue/React/Angular 皆有封裝)。
  • @dnd-kit:React 優先、無障礙優先、Headless、極佳 TypeScript 支援。
  • 原生 HTML Drag & Drop API:`draggable="true"` + `dragstart`/`dragover`/`drop`,但觸控裝置**完全不支援**,桌面端才適用。

結語

可拖曳排序列表的核心在於:**事件統一(Pointer Events)、視覺佔位、DOM 就地移動、Transform 動畫**。現代瀏覽器原生 API 已足夠強大,無需 jQuery UI Sortable 等重型庫。若專案需求複雜(跨列表、巢狀、虛擬列表),直接上 SortableJS 或 @dnd-kit,別重複造輪子。

copyright © 萬盛學電腦網 all rights reserved