萬盛學電腦網

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

ExtJS 拖曳功能實作:DragZone 與 DropZone 完整範例

ExtJS 拖曳核心概念

  • DragZone:拖曳來源區域,定義可被拖曳的元素
  • DropZone:拖曳目標區域,定義放置邏輯
  • Ext.dd.Registry:註冊可拖曳元素,提供查找機制
  • ddel (drag drop element):拖曳時顯示的代理元素

完整可執行範例

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <title>ExtJS Drag & Drop Demo</title>
  <!-- ExtJS 4/5/6/7 通用,請替換為實際 CDN 或本地路徑 -->
  <link rel="stylesheet" type="text/css" href="https://cdn.sencha.com/ext/trial/7.6.0/build/classic/theme-triton/resources/theme-triton-all.css">
  <script type="text/javascript" src="https://cdn.sencha.com/ext/trial/7.6.0/build/ext-all.js"></script>
  <script type="text/javascript" src="https://cdn.sencha.com/ext/trial/7.6.0/build/classic/locale/locale-zh_TW.js"></script>
  <style>
    body { padding: 20px; font-family: 'Microsoft JhengHei', sans-serif; }
    h1 { color: #2c3e50; border-bottom: 2px solid #3498db; padding-bottom: 5px; }
    ul { list-style: none; padding: 10px; min-height: 100px; border: 2px dashed #bdc3c7; border-radius: 6px; background: #f8f9fa; margin-bottom: 20px; }
    li { padding: 8px 12px; margin: 5px 0; background: #fff; border: 1px solid #ddd; border-radius: 4px; cursor: move; transition: box-shadow 0.2s; }
    li:hover { box-shadow: 0 2px 6px rgba(0,0,0,0.15); background: #e8f4fd; }
    .x-dd-drag-proxy { opacity: 0.8 !important; z-index: 10000; }
    .x-dd-drop-ok .x-dd-drop-icon { background-image: url(data:image/gif;base64,R0lGODlhEAAQAIUAAAAAAP///yH5BAEAAAAALAAAAAAQABAAAAIhRB6KncWsKfnUPnjKDxzX3qhXUfRgAOw==) !important; }
  </style>
</head>
<body>
  <h1>今日待辦 <span style="font-size:14px; color:#666; font-weight:normal">(拖曳至明日)</span></h1>
  <ul id="today">
    <li>🛒 購物買菜</li>
    <li>✂️ 剪髮</li>
  </ul>

  <h1>明日計畫 <span style="font-size:14px; color:#666; font-weight:normal">(拖曳至今日)</span></h1>
  <ul id="tmrw">
    <li>📅 會議 10:00</li>
    <li>📝 撰寫報告</li>
  </ul>

  <script>
    Ext.onReady(function() {
      // 1. 註冊所有 li 為可拖曳元素
      var items = document.querySelectorAll('#today li, #tmrw li');
      items.forEach(function(el) {
        Ext.dd.Registry.register(el);
      });

      // 2. 建立 DragZone (來源區域)
      var todayDrag = new Ext.dd.DragZone('today', {
        getDragData: function(e) {
          var target = e.getTarget('li');
          if (!target) return null;
          return {
            ddel: target.cloneNode(true), // 拖曳代理元素
            sourceEl: target,             // 來源元素
            sourceContainer: 'today',     // 來源容器 ID
            data: target.textContent      // 傳遞資料
          };
        },
        getRepairXY: function() {
          return this.dragData.sourceEl.getXY(); // 失敗時回到原位動畫
        }
      });

      var tmrwDrag = new Ext.dd.DragZone('tmrw', {
        getDragData: function(e) {
          var target = e.getTarget('li');
          if (!target) return null;
          return {
            ddel: target.cloneNode(true),
            sourceEl: target,
            sourceContainer: 'tmrw',
            data: target.textContent
          };
        },
        getRepairXY: function() {
          return this.dragData.sourceEl.getXY();
        }
      });

      // 3. 共用 Drop 邏輯
      function onNodeDrop(target, source, e, data) {
        // 移動 DOM
        var dragged = data.ddel;
        var sourceContainer = document.getElementById(data.sourceContainer);
        var destContainer = target.el.dom;
        
        sourceContainer.removeChild(data.sourceEl);
        destContainer.appendChild(dragged);
        
        // 重新註冊新位置的元素
        Ext.dd.Registry.register(dragged);
        return true; // 表示 drop 成功
      }

      // 4. 建立 DropZone (目標區域)
      var dropCfg = {
        onNodeDrop: onNodeDrop,
        // 可選:進入/離開視覺回饋
        onNodeEnter: function(target, source, e, data) {
          target.el.addCls('drop-target-hover');
        },
        onNodeOut: function(target, source, e, data) {
          target.el.removeCls('drop-target-hover');
        }
      };

      new Ext.dd.DropZone('today', dropCfg);
      new Ext.dd.DropZone('tmrw', dropCfg);

      // 5. 樣式增強
      Ext.get('today').addCls('drop-zone');
      Ext.get('tmrw').addCls('drop-zone');
    });
  </script>
</body>
</html>

關鍵 API 解析

方法/屬性用途
DragZone.getDragData(e)決定拖曳什麼資料,回傳含 ddel、sourceEl、data 的物件
DragZone.getRepairXY()拖曳失敗/取消時,元素回彈的目標座標
DropZone.onNodeDrop放置時執行,回傳 true 表示成功
DropZone.onNodeEnter/Out拖曳進入/離開目標區的視覺回饋
Ext.dd.Registry.register(el)註冊元素供 DropZone 查找

進階:資料同步至後端

function onNodeDrop(target, source, e, data) {
  // 1. 更新 UI
  var dragged = data.ddel;
  var sourceContainer = document.getElementById(data.sourceContainer);
  var destContainer = target.el.dom;
  sourceContainer.removeChild(data.sourceEl);
  destContainer.appendChild(dragged);
  Ext.dd.Registry.register(dragged);

  // 2. 同步後端 (AJAX)
  Ext.Ajax.request({
    url: '/api/tasks/reorder',
    method: 'POST',
    jsonData: {
      taskId: data.sourceEl.dataset.id,        // 假設 li 有 data-id
      fromList: data.sourceContainer,          // 'today' 或 'tmrw'
      toList: target.el.dom.id,                // 'today' 或 'tmrw'
      newIndex: Array.from(destContainer.children).indexOf(dragged)
    },
    success: function(response) {
      console.log('同步成功');
    },
    failure: function() {
      // 失敗可選:還原 UI 或提示使用者
      Ext.Msg.alert('同步失敗', '請重新整理頁面後再試');
    }
  });
  return true;
}

ExtJS 6/7 Modern Toolkit 寫法 (Ext.drag.Source / Target)

// Modern 工具包較新架構 (Ext JS 6.5+)
Ext.define('MyApp.view.TaskList', {
  extend: 'Ext.dataview.List',
  xtype: 'tasklist',
  config: {
    draggable: {
      // 設定可拖曳
    },
    droppable: {
      // 設定可放置
    }
  }
});

// 實際專案建議參考官方文件:Drag & Drop - Modern Toolkit

常見問題排查

  1. 拖曳無反應:確認 Ext.dd.Registry.register 已對每個子元素呼叫
  2. 代理元素樣式異常:ddel 需手動複製樣式或加上 .x-dd-drag-proxy 覆寫
  3. 巢狀容器衝突:使用 groups 參數區分不同 DragZone/DropZone 群組
  4. 觸控裝置不支援:Classic toolkit 預設僅滑鼠,需額外載入 Ext.dd.Touch 或改用 Modern toolkit
copyright © 萬盛學電腦網 all rights reserved