拖放效果大家都不陌生,ExtJS 把背後繁瑣的滑鼠事件處理封裝成兩個物件:DragZone 負責「可拖」,DropZone 負責「可放」。以下用一個「今日/明日」待辦清單示範。
<html>
<head>
<title>Drag & Drop Demo</title>
<link rel="Stylesheet" type="text/css" href="lib/extjs/resources/css/ext-all.css" />
<script type="text/javascript" src="lib/extjs/bootstrap.js"></script>
<script type="text/javascript" src="lib/extjs/locale/ext-lang-zh_CN.js"></script>
<script type="text/javascript">
Ext.onReady(function () {
var drags = document.getElementsByTagName('li');
for (var i = 0; i < drags.length; i++) {
Ext.dd.Registry.register(drags[i]);
}
// 兩側容器都開放拖入
new Ext.dd.DragZone('today');
new Ext.dd.DragZone('tmrw');
// 放下時把 DOM 節點搬到目標容器
function drop(dropNodeData, source, event, dragNodeData) {
var dragged = source.dragData.ddel;
var sourceContainer = source.el.dom;
var desContainer = this.getEl();
sourceContainer.removeChild(dragged);
desContainer.appendChild(dragged);
return true;
}
var cfg = { onNodeDrop: drop };
new Ext.dd.DropZone('today', cfg);
new Ext.dd.DropZone('tmrw', cfg);
});
</script>
</head>
<body>
<h1>Today</h1>
<ul id="today">
<li>shopping</li>
<li>haircut</li>
</ul>
<h1>Tomorrow</h1>
<ul id="tmrw">
<li>123</li>
<li>456</li>
</ul>
</body>
</html>
拖放登錄表。手動註冊每個 <li>,讓拖放管理器知道哪些 DOM 節點參與拖放。若改用 ExtJS 的元件(如 Grid、TreePanel),通常內建就已註冊好,不必手動處理。
把指定容器內的項目變成可拖曳。這裡對 today 與 tmrw 各建一個,因此兩個清單裡的項目都能被拖動。
把容器變成可放置的目標。透過設定物件 cfg 傳入 onNodeDrop 回呼,定義「放下之後要做什麼」。
dropNodeData:目標位置上那一節點的資料source:拖曳來源(DragZone),可從 source.dragData.ddel 拿到被拖的 DOM 元素event:原始的拖放事件物件dragNodeData:被拖節點的資料sourceContainer.removeChild(dragged);
desContainer.appendChild(dragged);
從來源容器移除,再附加到目標容器。因為是直接操作 DOM,所以兩側 <ul> 的內容會即時反映變化。this.getEl() 拿到的是 DropZone 綁定的那個容器元素——注意 this 在回呼中指向 DropZone 實例,而非被拖的元素。
true 代表接受,回 false 則 ExtJS 會把元素放回原位。若要依條件拒絕(例如目標已滿),就在這裡判斷並回 false。onDragEnter、onDragOver、onNodeEnter 等鉤子可覆寫。<li>,若日後版面新增其他清單,就會被誤註冊。改成 Ext.select('.drag-item').each(...) 較精準。draggable 屬性搭配 dragstart/dragover/drop 事件,或採用 SortableJS、dnd-kit 這類專門函式庫,不必為了拖放而引入整套 ExtJS。