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
常見問題排查
- 拖曳無反應:確認
Ext.dd.Registry.register 已對每個子元素呼叫
- 代理元素樣式異常:
ddel 需手動複製樣式或加上 .x-dd-drag-proxy 覆寫
- 巢狀容器衝突:使用
groups 參數區分不同 DragZone/DropZone 群組
- 觸控裝置不支援:Classic toolkit 預設僅滑鼠,需額外載入
Ext.dd.Touch 或改用 Modern toolkit