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' )
posted on 2011-04-28 09:18 Joey_zy0210 阅读(5561) 评论(0) 编辑 收藏 举报