jquery sortable簡述

                               jquery sortable 

概述  

Selectable插件允許用戶對指定的元素進(jìn)行選中的動作。此外還支持按住Ctrl鍵單擊或拖拽選擇多個元素。  

官方示例地址：

所有的事件回調(diào)函數(shù)都有兩個參數(shù)：event和ui，瀏覽器自有event對象，和經(jīng)過封裝的ui對象  

ui.helper - 表示sortable元素的JQuery對象，通常是當(dāng)前元素的克隆對象  

ui.position - 表示相對當(dāng)前對象，鼠標(biāo)的坐標(biāo)值對象{top,left}  

ui.offset - 表示相對于當(dāng)前頁面，鼠標(biāo)的坐標(biāo)值對象{top,left}  

ui.item - 表示當(dāng)前拖拽的元素  

ui.placeholder - 占位符（如果有定義的話）  

ui.sender - 當(dāng)前拖拽元素的所屬sortable對象（僅當(dāng)元素是從另一個sortable對象傳遞過來時有用）  

·參數(shù)（參數(shù)名 : 參數(shù)類型 : 默認(rèn)值）  

appendTo : String : 'parent'

Defines where the helper that moves with the mouse is being appended to during the drag (for example, to resolve overlap/zIndex issues).  

初始：$('.selector').sortable({ appendTo: 'body' });  

獲?。簐ar appendTo = $('.selector').sortable('option', 'appendTo');  

設(shè)置：$('.selector').sortable('option', 'appendTo', 'body');  

axis : String : false   

如果有設(shè)置，則元素僅能橫向或縱向拖動?？蛇x值：'x', 'y'

初始：$('.selector').sortable({ axis: 'x' });  

獲?。簐ar axis = $('.selector').sortable('option', 'axis');  

設(shè)置：$('.selector').sortable('option', 'axis', 'x');  

cancel : Selector : ':input,button'   

阻止排序動作在匹配的元素上發(fā)生。  

初始：$('.selector').sortable({ cancel: 'button' });  

獲?。簐ar cancel = $('.selector').sortable('option', 'cancel');  

設(shè)置：$('.selector').sortable('option', 'cancel', 'button');  

connectWith : Selector : false   

允許sortable對象連接另一個sortable對象，可將item元素拖拽到另一個中。  

初始：$('.selector').sortable({ connectWith: '.otherlist' });  

獲?。簐ar connectWith = $('.selector').sortable('option', 'connectWith');  

設(shè)置：$('.selector').sortable('option', 'connectWith', '.otherlist');  

containment : Element, String, Selector : false   

約束排序動作只能在一個指定的范圍內(nèi)發(fā)生。可選值：DOM對象, 'parent', 'document', 'window', 或jQuery對象  

初始：$('.selector').sortable({ containment: 'parent' });  

獲?。簐ar containment = $('.selector').sortable('option', 'containment');  

設(shè)置：$('.selector').sortable('option', 'containment', 'parent');  

cursor : String : 'auto'

定義在開始排序動作時，如果的樣式。  

初始：$('.selector').sortable({ cursor: 'crosshair' });  

獲?。簐ar cursor = $('.selector').sortable('option', 'cursor');  

設(shè)置：$('.selector').sortable('option', 'cursor', 'crosshair');  

cursorAt : Object : false   

當(dāng)開始移動時，鼠標(biāo)定位在的某個位置上（最多兩個方向）?？蛇x值：{ top, left, right, bottom }.  

初始：$('.selector').sortable({ cursorAt: 'top' });  

獲?。簐ar cursorAt = $('.selector').sortable('option', 'cursorAt');  

設(shè)置：$('.selector').sortable('option', 'cursorAt', 'top');  

delay : Integer : 0  

以毫秒為單位，設(shè)置延遲多久才激活排序動作。此參數(shù)可防止誤點(diǎn)擊。  

初始：$('.selector').sortable({ delay: 500 });  

獲?。簐ar delay = $('.selector').sortable('option', 'delay');  

設(shè)置：$('.selector').sortable('option', 'delay', 500);  

distance : Integer : 1  

決定至少要在元素上面拖動多少像素后，才正式觸發(fā)排序動作。  

初始：$('.selector').sortable({ distance: 30 });  

獲?。簐ar distance = $('.selector').sortable('option', 'distance');  

設(shè)置：$('.selector').sortable('option', 'distance', 30);  

dropOnEmpty : Boolean : true   

是否允許拖拽到一個空的sortable對象中。  

初始：$('.selector').sortable({ dropOnEmpty: false });  

獲?。簐ar dropOnEmpty = $('.selector').sortable('option', 'dropOnEmpty');  

設(shè)置：$('.selector').sortable('option', 'dropOnEmpty', false);  

forceHelperSize : Boolean : false   

If true, forces the helper to have a size.  

初始：$('.selector').sortable({ forceHelperSize: true });  

獲?。簐ar forceHelperSize = $('.selector').sortable('option', 'forceHelperSize');  

設(shè)置：$('.selector').sortable('option', 'forceHelperSize', true);  

forcePlaceholderSize : Boolean : false

If true, forces the placeholder to have a size.  

初始：$('.selector').sortable({ forcePlaceholderSize: true });  

獲?。簐ar forcePlaceholderSize = $('.selector').sortable('option', 'forcePlaceholderSize');  

設(shè)置：$('.selector').sortable('option', 'forcePlaceholderSize', true);  

grid : Array : false   

將排序?qū)ο蟮膇tem元素視為一個格子處理，每次移動都按一個格子大小移動，數(shù)組值：[x,y]  

初始：$('.selector').sortable({ grid: [50, 20] });  

獲?。簐ar grid = $('.selector').sortable('option', 'grid');  

設(shè)置：$('.selector').sortable('option', 'grid', [50, 20]);  

handle : Selector, Element : false   

限制排序的動作只能在item元素中的某個元素開始。  

初始：$('.selector').sortable({ handle: 'h3' });  

獲?。簐ar handle = $('.selector').sortable('option', 'handle');  

設(shè)置：$('.selector').sortable('option', 'handle', 'h3');  

helper : String, Function : 'original'   

設(shè)置是否在拖拽元素時，顯示一個輔助的元素。可選值：'original', 'clone'

初始：$('.selector').sortable({ helper: 'clone' });  

獲?。簐ar helper = $('.selector').sortable('option', 'helper');  

設(shè)置：$('.selector').sortable('option', 'helper', 'clone');  

items : Selector : '> *'   

指定在排序?qū)ο笾?，哪些元素是可以進(jìn)行拖拽排序的。  

初始：$('.selector').sortable({ items: 'li' });  

獲?。簐ar items = $('.selector').sortable('option', 'items');  

設(shè)置：$('.selector').sortable('option', 'items', 'li');  

opacity : Float : false   

定義當(dāng)排序時，輔助元素(helper)顯示的透明度。  

初始：$('.selector').sortable({ opacity: 0.6 });  

獲?。簐ar opacity = $('.selector').sortable('option', 'opacity');  

設(shè)置：$('.selector').sortable('option', 'opacity', 0.6);  

placeholderType: StringDefault: false   

設(shè)置當(dāng)排序動作發(fā)生時，空白占位符的CSS樣式。  

初始：$('.selector').sortable({ placeholder: 'ui-state-highlight' });  

獲?。簐ar placeholder = $('.selector').sortable('option', 'placeholder');  

設(shè)置：$('.selector').sortable('option', 'placeholder', 'ui-state-highlight');  

revert : Boolean : false

如果設(shè)置成true，則被拖拽的元素在返回新位置時，會有一個動畫效果。  

初始：$('.selector').sortable({ revert: true });  

獲?。簐ar revert = $('.selector').sortable('option', 'revert');  

設(shè)置：$('.selector').sortable('option', 'revert', true);  

scroll : Boolean : true

如果設(shè)置成true，則元素被拖動到頁面邊緣時，會自動滾動。  

初始：$('.selector').sortable({ scroll: false });  

獲取：var scroll = $('.selector').sortable('option', 'scroll');  

設(shè)置：$('.selector').sortable('option', 'scroll', false);  

scrollSensitivity : Integer : 20   

設(shè)置當(dāng)元素移動至邊緣多少像素時，便開始滾動頁面。  

初始：$('.selector').sortable({ scrollSensitivity: 40 });  

獲?。簐ar scrollSensitivity = $('.selector').sortable('option', 'scrollSensitivity');  

設(shè)置：$('.selector').sortable('option', 'scrollSensitivity', 40);  

scrollSpeed : Integer : 20  

設(shè)置頁面滾動的速度。  

初始：$('.selector').sortable({ scrollSpeed: 40 });  

獲取：var scrollSpeed = $('.selector').sortable('option', 'scrollSpeed');  

設(shè)置：$('.selector').sortable('option', 'scrollSpeed', 40);  

tolerance : String : 'intersect'

設(shè)置當(dāng)拖動元素越過其它元素多少時便對元素進(jìn)行重新排序?？蛇x值：'intersect', 'pointer'

intersect：至少重疊50%  

pointer：鼠標(biāo)指針重疊元素  

初始：$('.selector').sortable({ tolerance: 'pointer' });  

獲?。簐ar tolerance = $('.selector').sortable('option', 'tolerance');  

設(shè)置：$('.selector').sortable('option', 'tolerance', 'pointer');  

zIndex : Integer : 1000  

設(shè)置在排序動作發(fā)生時，元素的z-index值。  

初始：$('.selector').sortable({ zIndex: 5 });  

獲?。簐ar zIndex = $('.selector').sortable('option', 'zIndex');  

設(shè)置：$('.selector').sortable('option', 'zIndex', 5);  

·事件  

start  

當(dāng)排序動作開始時觸發(fā)此事件。  

定義：$('.selector').sortable({ start: function(event, ui) { ... } });  

綁定：$('.selector').bind('sortstart', function(event, ui) { ... });  

sort  

當(dāng)元素發(fā)生排序時觸發(fā)此事件。  

定義：$('.selector').sortable({ sort: function(event, ui) { ... } });  

綁定：$('.selector').bind('sort', function(event, ui) { ... });  

change  

當(dāng)元素發(fā)生排序且坐標(biāo)已發(fā)生改變時觸發(fā)此事件。  

定義：$('.selector').sortable({ change: function(event, ui) { ... } });  

綁定：$('.selector').bind('sortchange', function(event, ui) { ... });  

beforeStop  

當(dāng)排序動作結(jié)束之前觸發(fā)此事件。此時占位符元素和輔助元素仍有效。  

定義：$('.selector').sortable({ beforeStop: function(event, ui) { ... } });  

綁定：$('.selector').bind('sortbeforeStop', function(event, ui) { ... });  

stop  

當(dāng)排序動作結(jié)束時觸發(fā)此事件。  

定義：$('.selector').sortable({ stop: function(event, ui) { ... } });  

綁定：$('.selector').bind('sortstop', function(event, ui) { ... });  

update  

當(dāng)排序動作結(jié)束時且元素坐標(biāo)已經(jīng)發(fā)生改變時觸發(fā)此事件。  

定義：$('.selector').sortable({ update: function(event, ui) { ... } });  

綁定：$('.selector').bind('sortupdate', function(event, ui) { ... });  

receive  

當(dāng)一個已連接的sortable對象接收到另一個sortable對象的元素后觸發(fā)此事件。  

定義：$('.selector').sortable({ receive: function(event, ui) { ... } });  

綁定：$('.selector').bind('sortreceive', function(event, ui) { ... });  

over  

當(dāng)一個元素拖拽移入另一個sortable對象后觸發(fā)此事件。  

定義：$('.selector').sortable({ over: function(event, ui) { ... } });  

綁定：$('.selector').bind('sortover', function(event, ui) { ... });  

out  

當(dāng)一個元素拖拽移出sortable對象移出并進(jìn)入另一個sortable對象后觸發(fā)此事件。  

定義：$('.selector').sortable({ out: function(event, ui) { ... } });  

綁定：$('.selector').bind('sortout', function(event, ui) { ... });  

activate  

當(dāng)一個有使用連接的sortable對象開始排序動作時，所有允許的sortable觸發(fā)此事件。  

定義：$('.selector').sortable({ activate: function(event, ui) { ... } });  

綁定：$('.selector').bind('sortactivate', function(event, ui) { ... });  

deactivate  

當(dāng)一個有使用連接的sortable對象結(jié)束排序動作時，所有允許的sortable觸發(fā)此事件。  

定義：$('.selector').sortable({ deactivate: function(event, ui) { ... } });  

綁定：$('.selector').bind('sortdeactivate', function(event, ui) { ... });  

·方法  

destory  

從元素中移除拖拽功能。  

用法：.sortable( 'destroy' )  

disable  

禁用元素的拖拽功能。  

用法：.sortable( 'disable' )  

enable  

啟用元素的拖拽功能。  

用法：.sortable( 'enable' )  

option  

獲取或設(shè)置元素的參數(shù)。  

用法：.sortable( 'option' , optionName , [value] )  

serialize  

獲取或設(shè)置序列化后的每個item元素的id屬性。  

用法：.sortable( 'serialize' , [options] )  

toArray  

獲取序列化后的每個item元素的id屬性的數(shù)組。  

用法：.sortable( 'toArray' ）  

refresh  

手動重新刷新當(dāng)前sortable對象的item元素的排序。  

用法：.sortable( 'refresh' )  

refreshPositions  

手動重新刷新當(dāng)前sortable對象的item元素的坐標(biāo)，此方法可能會降低性能。  

用法：.sortable( 'refreshPositions' )  

cancel  

取消當(dāng)前sortable對象中item元素的排序改變。  

用法：.sortable( 'cancel' )