拖曳是 RIA 介面裡最容易被過度使用的效果,但只要參數調得對,它也能變成很自然的操作方式。以下是 jQuery UI Draggable 的常用參數整理。
需要的檔案:ui/ui.core.js 與 ui/ui.draggable.js。
$("#draggable").draggable();
$("#draggable").draggable({ axis: 'y' }); // 只沿 Y 軸
$("#draggable2").draggable({ axis: 'x' }); // 只沿 X 軸
// 限制在指定容器內,且不顯示滾動條
$("#draggable3").draggable({ containment: '#containment-wrapper', scroll: false });
$("#draggable4").draggable({ containment: '#demo-frame' });
$("#draggable5").draggable({ containment: 'parent' }); // 限制在父元素內
$("#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 為格線移動
snapMode 有兩種:outer 是「本上吸其下、本下吸其上」;inner 方向相反。
$("#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',只在沒有放進有效 droppable 區域時才復位。
$("#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>自訂提示元素</div>');
}
});
$("#set div").draggable({ stack: { group: '#set div', min: -1 } });
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 } });
cursorAt 決定拖曳時游標與元素的相對定位點,top、left、right、bottom 可任意搭配。
$("#sortable").sortable({ revert: true });
$("#draggable").draggable({
connectToSortable: '#sortable',
helper: 'clone',
revert: 'invalid'
});
connectToSortable 讓被拖曳的元素能直接放進排序列表中,是「資源庫拖進清單」這類介面的核心做法。實作時記得在元素的某一端加上 class 標記來源,放進列表後再移除,否則同一個項目可能被重複加入。