DIV CSS 佈局教程網

jQuery UI Draggable 參數完整整理
編輯:JQuery特效代碼     

拖曳是 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 可任意搭配。

Draggable 搭配 Sortable

$("#sortable").sortable({ revert: true });

$("#draggable").draggable({
  connectToSortable: '#sortable',
  helper: 'clone',
  revert: 'invalid'
});

connectToSortable 讓被拖曳的元素能直接放進排序列表中,是「資源庫拖進清單」這類介面的核心做法。實作時記得在元素的某一端加上 class 標記來源,放進列表後再移除,否則同一個項目可能被重複加入。

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