Draggable 是 jQuery UI 裡最常被拿來做視覺互動的元件。要使用它,除了 jQuery 本體之外,還必須載入 ui/ui.core.js 與 ui/ui.draggable.js 兩個檔案。
最基本的形式只要一行:
$("#draggable").draggable();
$("#draggable").draggable({ axis: 'y' }); // 只允許上下
$("#draggable2").draggable({ axis: 'x' }); // 只允許左右
$("#draggable3").draggable({ containment: '#containment-wrapper', scroll: false }); // 關閉滾動
$("#draggable4").draggable({ containment: '#demo-frame' });
$("#draggable5").draggable({ containment: 'parent' }); // 限制在父容器內
axis 鎖定單一軸向,containment 則把元素關進指定範圍,可填選擇器、parent 或 array。
$("#draggable").draggable({ distance: 20 }); // 拖動超過 20px 才啟動
$("#draggable2").draggable({ delay: 1000 }); // 按住 1 秒後才啟動
這兩個參數能有效避免「只是想點一下卻被拖走」的困擾,在需要同時支援點擊事件的元件上特別有用。
$("#draggable").draggable({ snap: true }); // 對任意元素吸附
$("#draggable2").draggable({ snap: '.ui-widget-header' });
$("#draggable3").draggable({ snap: '.ui-widget-header', snapMode: 'outer' }); // 以元素外緣吸附
$("#draggable4").draggable({ grid: [20,20] }); // 以 20px 網格移動
$("#draggable5").draggable({ grid: [80, 80] });
snapMode 有 inner 與 outer 兩種:outer 是彼此外緣靠近時吸住,inner 則相反。grid 讓移動以固定間距跳格,做出整齊的排版效果。
$("#draggable").draggable({ scroll: true });
$("#draggable2").draggable({ scroll: true, scrollSensitivity: 100 }); // 邊緣多近時觸發滾動
$("#draggable3").draggable({ scroll: true, scrollSpeed: 100 }); // 滾動速度
$("#draggable").draggable({ revert: true }); // 放開後歸位
$("#draggable2").draggable({ revert: true, helper: 'clone' }); // 拖曳時留下原體,丟出後歸位
revert: 'invalid' 可以只在沒有成功放入目標區時才歸位,搭配 sortable 使用很順手。
$("#draggable").draggable({ helper: 'original' }); // 直接移動原元素
$("#draggable2").draggable({ opacity: 0.7, helper: 'clone' }); // 半透明複本
$("#draggable3").draggable({
cursor: 'move',
cursorAt: { top: -12, left: -20 },
helper: function(event) { return $("<div>I'm a custom helper</div>"); }
});
$("#set div").draggable({ stack: { group: '#set div', min: -1 } });
helper 決定拖曳時「動的是誰」:original 動本體,clone 動複本。opacity 讓複本變半透明以示區別。helper 也能傳入函式自訂外觀。stack 則讓同群組的元素在被拖動時自動疊到最上層,很適合做許願板或小卡片的堆疊效果。
$("#draggable").draggable({ handle: 'p' }); // 只有 p 區域可拖
$("#draggable2").draggable({ cancel: "p.ui-widget-header" }); // 排除指定區域
$("#draggable").draggable({ cursorAt: { cursor: 'move', top: 56, left: 56 } }); // 游標與元素的相對定位
$("#draggable2").draggable({ cursorAt: { cursor: 'crosshair', top: -5, left: -5 } });
$("#draggable3").draggable({ cursorAt: { bottom: 0 } });
cursor 決定游標圖示,cursorAt 的 top、left、right、bottom 則設定元素左上角相對於游標的偏移量,數值為負代表游標落在元素內部。
$("#sortable").sortable({ revert: true });
$("#draggable").draggable({
connectToSortable: '#sortable',
helper: 'clone',
revert: 'invalid'
});
connectToSortable 是相當實用的一組搭配:它讓原本自由拖曳的元素可以被丟進排序清單中,並自動參與排序邏輯。做看板、待辦清單、素材庫拖放時,這幾個參數幾乎一定會用到。