依賴檔案
<script src="ui/ui.core.js"></script>
<script src="ui/ui.draggable.js"></script>
基礎初始化
$("#draggable").draggable();
分類參數詳解
1. 限制移動範圍 constrain-movement
// 僅限 Y 軸
$("#draggable").draggable({ axis: 'y' });
// 僅限 X 軸
$("#draggable2").draggable({ axis: 'x' });
// 限制在指定容器內,不出現捲軸
$("#draggable3").draggable({ containment: '#containment-wrapper', scroll: false });
// 限制在父元素內
$("#draggable5").draggable({ containment: 'parent' });
2. 延遲啟動 delay-start
// 滑鼠移動 20px 後才開始拖曳
$("#draggable").draggable({ distance: 20 });
// 延遲 1000ms 後才可拖曳
$("#draggable2").draggable({ delay: 1000 });
3. 吸附/對齊 snap-to
// 吸附任何元素
$("#draggable").draggable({ snap: true });
// 吸附特定元素的邊界
$("#draggable2").draggable({ snap: '.ui-widget-header' });
// 僅以外徑吸附
$("#draggable3").draggable({ snap: '.ui-widget-header', snapMode: 'outer' });
// 網格對齊:每 20px 一格
$("#draggable4").draggable({ grid: [20, 20] });
4. 容器捲動 scroll
$("#draggable").draggable({ scroll: true });
$("#draggable2").draggable({ scroll: true, scrollSensitivity: 100 }); // 觸發捲動的邊緣距離
$("#draggable3").draggable({ scroll: true, scrollSpeed: 100 }); // 捲動速度
5. 還原位置 revert
// 鬆開滑鼠自動回原位
$("#draggable").draggable({ revert: true });
// 複製模式拖曳並回原位
$("#draggable2").draggable({ revert: true, helper: 'clone' });
6. 視覺回饋 visual-feedback
// 預設:拖曳原元素
$("#draggable").draggable({ helper: 'original' });
// 半透明複製拖曳
$("#draggable2").draggable({ opacity: 0.7, helper: 'clone' });
// 自訂游標與偏移
$("#draggable3").draggable({
cursor: 'move',
cursorAt: { top: -12, left: -20 },
helper: function(event) {
return $('I\'m a custom helper
');
}
});
// 群組堆疊管理(適合許願板)
$("#set div").draggable({ stack: { group: '#set div', min: -1 } });
7. 拖曳手柄與取消區域
// 僅點擊 <p> 時可拖曳
$("#draggable").draggable({ handle: 'p' });
// 點擊 .ui-widget-header 時不可拖曳
$("#draggable2").draggable({ cancel: "p.ui-widget-header" });
8. 游標樣式 cursorAt
$("#draggable").draggable({ cursorAt: { cursor: 'move', top: 56, left: 56 } });
$("#draggable2").draggable({ cursorAt: { cursor: 'crosshair', top: -5, left: -5 } });
$("#draggable3").draggable({ cursorAt: { bottom: 0 } });
9. Draggable + Sortable 聯動
$("#sortable").sortable({ revert: true });
$("#draggable").draggable({
connectToSortable: '#sortable', // 拖入可排序列表
helper: 'clone',
revert: 'invalid' // 若未放入可排序區則回原位
});