DIV CSS 佈局教程網

jQuery UI Draggable 參數全解:拖曳的 12 組設定
編輯:JavaScript綜合知識     

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").sortable({ revert: true });
$("#draggable").draggable({
  connectToSortable: '#sortable',
  helper: 'clone',
  revert: 'invalid'
});

connectToSortable 是相當實用的一組搭配:它讓原本自由拖曳的元素可以被丟進排序清單中,並自動參與排序邏輯。做看板、待辦清單、素材庫拖放時,這幾個參數幾乎一定會用到。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved