DIV CSS 佈局教程網

ExtJS 拖放實作:DragZone 與 DropZone 打造待辦清單搬移
編輯:JavaScript綜合知識     

拖放效果大家都不陌生,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>

四個元件的分工

Ext.dd.Registry

拖放登錄表。手動註冊每個 <li>,讓拖放管理器知道哪些 DOM 節點參與拖放。若改用 ExtJS 的元件(如 Grid、TreePanel),通常內建就已註冊好,不必手動處理。

Ext.dd.DragZone

把指定容器內的項目變成可拖曳。這裡對 today 與 tmrw 各建一個,因此兩個清單裡的項目都能被拖動。

Ext.dd.DropZone

把容器變成可放置的目標。透過設定物件 cfg 傳入 onNodeDrop 回呼,定義「放下之後要做什麼」。

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。
  • 記得設定視覺回饋。拖曳中、可放置、正在 hover 都應該有不同的樣式提示,否則使用者不知道能不能放。ExtJS 提供了 onDragEnter、onDragOver、onNodeEnter 等鉤子可覆寫。
  • 用 class 選擇器取代 getElementsByTagName。原寫法註冊了頁面上所有 <li>,若日後版面新增其他清單,就會被誤註冊。改成 Ext.select('.drag-item').each(...) 較精準。
  • 拖放只是前端效果,狀態要落地。若清單順序需要保存,必須在 drop 回呼中送出新的順序到後端,否則重新整理後就會全部跑回原樣。
  • 行動裝置需額外處理。HTML5 原生拖放與 ExtJS 的滑鼠導向實作在觸控裝置上都需要額外套件支援。
  • 現代替代方案。新專案可直接用 HTML5 的 draggable 屬性搭配 dragstart/dragover/drop 事件,或採用 SortableJS、dnd-kit 這類專門函式庫,不必為了拖放而引入整套 ExtJS。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved