Ajax 渲染的樹節點無法在創建時綁定 .draggable(),且容器 overflow:auto 導致拖拽元素被剪切或出現滾動條。
核心思想:頁面預置一個隱藏的 #dragProxy 作為唯一拖拽主體,滑鼠按下樹節點時:
mousedown 事件,接管拖拽<div id="dragProxy" class="ui-widget-content" style="display:none; position:absolute; z-index:9999;">
<!-- 運行時動態注入內容 -->
</div>
<div class="left-panel">
<ul class="tree">
<li class="node parent">父節點
<ul><li class="node child">子節點</li></ul>
</li>
</ul>
</div>
<div class="right-panel">
<div class="drop-zone new-zone">新建區域</div>
<div class="drop-zone existing-zone">現有區域</div>
</div>
let dragSource = null; // 記錄拖拽源節點
const $proxy = $('#dragProxy').draggable({
containment: 'document', // 突破容器限制
helper: 'clone', // 使用克隆輔助元素,原 proxy 隱藏
appendTo: 'body', // 掛載到 body 避免定位上下文干擾
zIndex: 9999,
start: (e, ui) => {
// 將源節點內容注入輔助元素
ui.helper.html(dragSource.html()).addClass('dragging');
},
drag: (e, ui) => {
// 可選:實時顯示放置預覽
},
stop: () => {
dragSource = null;
}
});
// 樹節點滑鼠按下:啟動代理拖拽
$('.tree .node').on('mousedown', function(e) {
dragSource = $(this);
$proxy.css({ top: e.pageY, left: e.pageX }).show();
// 手動觸發 proxy 的 mousedown,接管拖拽流程
$proxy.trigger($.Event('mousedown', { pageX: e.pageX, pageY: e.pageY, which: 1 }));
return false; // 阻止默認選中行為
});
// 放置區配置
$('.drop-zone').droppable({
accept: '.dragging', // 只接受正在拖拽的代理元素
activeClass: 'drop-active',
hoverClass: 'drop-hover',
tolerance: 'pointer', // 滑鼠指針進入即判定
drop: (e, ui) => {
const $zone = $(this);
const $source = dragSource;
if (!$source) return;
// 判斷是父節點(含子節點)還是葉子節點
const isParent = $source.hasClass('parent');
const nodesToMove = isParent ? $source.find('.node').addBack() : $source;
// 克隆節點到放置區(或移動,視業務而定)
nodesToMove.clone().appendTo($zone).removeClass('node').addClass('placed-item');
// 觸發業務邏輯:AJAX 保存新結構等
saveStructure($zone, nodesToMove);
}
});
默認 containment: 'parent' 會將拖拽限制在父容器內。設置為 'document' 或 'window' 可讓代理元素自由跨越左右面板。
#dragProxy 保持隱藏、零尺寸.ui-draggable-helperbody,脫離原定位上下文手動構造 $.Event('mousedown', {pageX, pageY, which:1}) 觸發代理元素拖拽,實現「點擊樹節點 → 代理元素跟隨滑鼠」的無縫體驗。
const nodesToMove = isParent
? $source.find('.node').addBack() // 後代 + 自身
: $source;
利用 jQuery .addBack() 將當前元素加入選擇集,配合 .find() 獲取完整子樹。
| 增強點 | 實現方案 |
|---|---|
| 拖拽預覽圖標 | helper: function() { return $(' |
| 放置區高亮動畫 | CSS .drop-hover { box-shadow: 0 0 10px #007bff; transition: box-shadow .2s; } |
| 撤銷/重做 | Command 模式記錄每次拖拽操作,維護歷史棧 |
| 觸屏支援 | 引入 jquery-ui-touch-punch 或原生 Pointer Events 適配 |
| 虛擬滾動大數據 | 樹節點虛擬化渲染,拖拽時動態加載可見區域 |
| 方案 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|
| jQuery UI | API 成熟、瀏覽器兼容好 | 體積大、非模組化、維護緩慢 | 老項目維護、IE11 必須支援 |
| SortableJS | 輕量、無依賴、支援觸屏、Tree 拖拽插件豐富 | 學習曲線稍陡 | 新項目首選、移動端優先 |
| dnd-kit (React) | 無頭、可訪問性強、TypeScript 優先 | 僅限 React 生態 | React 應用 |
| 原生 HTML5 DnD API | 零依賴、原生效能 | API 反直覺、移動端不支援、樣式難控制 | 極簡場景、無框架環境 |
「代理拖拽元素」模式完美解決了動態內容綁定難、容器溢出剪切、跨區域拖拽三大經典痛點。核心模式可抽象為通用 Hook/Composable,在 Vue/React/Angular 中同樣適用。選擇庫時:老項目用 jQuery UI 穩妥,新項目首選 SortableJS 或框架專用庫——別在 2024 年為了拖拽重寫 jQuery UI 依賴。