JQuery UI – selectable 中文文档

Selectable插件允许用户对指定的元素进行选中的动作。此外还支持按住Ctrl键单击或拖拽选择多个元素。
官方示例地址：http://jqueryui.com/demos/selectable/

·参数（参数名 : 参数类型 : 默认值）
autoRefresh : Boolean : true
决定是否在每次选择动作时，都重新计算每个选中元素的坐标和大小。如果你有很多个选择项的话，建议设置成false并通过方法手动刷新。
初始：$(‘.selector’).selectable({ autoRefresh: false });
获取：var autoRefresh = $(‘.selector’).selectable(‘option’, ‘autoRefresh’);
设置：$(‘.selector’).selectable(‘option’, ‘autoRefresh’, false);

autoRefresh : Boolean : true
决定是否在每次选择动作时，都重新计算每个选中元素的坐标和大小。如果你有很多个选择项的话，建议设置成false并通过方法手动刷新。
初始：$(‘.selector’).selectable({ autoRefresh: false });
获取：var autoRefresh = $(‘.selector’).selectable(‘option’, ‘autoRefresh’);
设置：$(‘.selector’).selectable(‘option’, ‘autoRefresh’, false);

cancel : Selector : ‘:input,option’
防止在与选择器相匹配的元素上发生选择动作。
初始：$(‘.selector’).selectable({ cancel: ‘:input,option’ });
获取：var cancel = $(‘.selector’).selectable(‘option’, ‘cancel’);
设置：$(‘.selector’).selectable(‘option’, ‘cancel’, ‘:input,option’);

delay : Integer : 0
以毫秒为单位，设置延迟多久才激活选择动作。此参数可防止误点击。
初始：$(‘.selector’).selectable({ delay: 20 });
获取：var delay = $(‘.selector’).selectable(‘option’, ‘delay’);
设置：$(‘.selector’).selectable(‘option’, ‘delay’, 20);

distance : Integer : 0
决定至少要在元素上面拖动多少像素后，才正式触发选中的动作。
初始：$(‘.selector’).selectable({ distance: 20 });
获取：var distance = $(‘.selector’).selectable(‘option’, ‘distance’);
设置：$(‘.selector’).selectable(‘option’, ‘distance’, 20);

filter : Selector : ‘*’
设置哪些子元素才可以被选中。
初始：$(‘.selector’).selectable({ filter: ‘li’ });
获取：var filter = $(‘.selector’).selectable(‘option’, ‘filter’);
设置：$(‘.selector’).selectable(‘option’, ‘filter’, ‘li’);

tolerance : String : ‘touch’
可选值：’touch’, ‘fit’，分别代表完全和部署覆盖元素即触发选中动作。
初始：$(‘.selector’).selectable({ tolerance: ‘fit’ });
获取：var tolerance = $(‘.selector’).selectable(‘option’, ‘tolerance’);
设置：$(‘.selector’).selectable(‘option’, ‘tolerance’, ‘fit’);

·事件
selected
当选中某一个元素后触发此事件。
初始：$(‘.selector’).selectable({ selected: function(event, ui) { … } });
绑定：$(‘.selector’).bind(‘selected’, function(event, ui) { … });

selecting
当选中某一个元素时触发此事件。
初始：$(‘.selector’).selectable({ selecting: function(event, ui) { … } });
绑定：$(‘.selector’).bind(‘selecting’, function(event, ui) { … });

start
当开始准备要选中一个元素时触发此事件。
初始：$(‘.selector’).selectable({ start: function(event, ui) { … } });
绑定：$(‘.selector’).bind(‘selectablestart’, function(event, ui) { … });

stop
当已经结束选中一个元素时触发此事件。
初始：$(‘.selector’).selectable({ stop: function(event, ui) { … } });
绑定：$(‘.selector’).bind(‘selectablestop’, function(event, ui) { … });

unselected
当取消选中某一个元素后触发此事件。
初始：$(‘.selector’).selectable({ unselected: function(event, ui) { … } });
绑定：$(‘.selector’).bind(‘unselected’, function(event, ui) { … });

unselecting
当取消选中某一个元素后触发此事件。
初始：$(‘.selector’).selectable({ unselecting: function(event, ui) { … } });
绑定：$(‘.selector’).bind(‘unselecting’, function(event, ui) { … });

·方法
destory
从元素中移除拖拽功能。
用法：.droppable( ‘destroy’ )

disable
禁用元素的拖拽功能。
用法：.droppable( ‘disable’ )

enable
启用元素的拖拽功能。
用法：.droppable( ‘enable’ )

option
获取或设置元素的参数。
用法：.droppable( ‘option’ , optionName , [value] )

refresh
用于手动刷新、重新计算每个选中元素的位置和大小。当autoRefresh设置成false，此方法对于刷新大量选中项非常有用。
用法：.selectable( ‘refresh’ )