滑块条

AuxUI 概览,下载、使用,模板示例,二次开发……

滑动型输入器,展示当前值和可选范围,当用户需要在数值区间/自定义区间内进行选择时使用

默认


范围滑块


自定义手柄


多个滑块

88 77 55 33 40 45 70

最大固定范围


最小固定范围


滑块绑定选择


增量


垂直滑块


垂直范围




选项

名称 类型 描述 默认值
animate Boolean/String/Number Boolean:设置true为时,句柄将使用默认持续时间设置动画
String :速度的名称,例如"fast"或"slow"
Number:动画的持续时间,以毫秒为单位
false
classes Object 指定要添加到元素的其他类 { "ui-slider": "ui-corner-all", "ui-slider-handle": "ui-corner-all", "ui-slider-range": "ui-corner-all ui-widget-header" }
disabled Boolean 如果设置为true,则禁用滑块 false
max Number 滑块条最大值 100
min String 滑块条最小值 0
orientation Number 确定滑块手柄是否水平移动(左边的最小值,右边的最大值)或垂直(底部的最小值,顶部的最大值)。可能的值:"horizontal","vertical"。 "horizontal"
range Boolean/String 滑块是否表示范围,支持多种类型:
Boolean:如果设置为true,滑块将检测您是否有两个手柄,并在这两个手柄之间创建一个可设置样式的范围元素。
String:"min"或者是"max"。最小范围从滑块min到一个手柄。最大范围从一个手柄到最大滑块。
false
step Number 确定滑块在最​​小值和最大值之间的每个间隔或步长的大小或数量。滑块的完整指定值范围(max - min)应该可以被步长整除 1
value Number 如果只有一个手柄,则确定滑块的值。如果有多个句柄,则确定第一个句柄的值 0
values Array 此选项可用于指定多个句柄。如果range选项设置为true,则长度values应为2 null

初始化后获取或设置选项示例:



方法

名称 描述 示例
.destroy() 完全删除滑块功能。这将使元素返回到pre-init状态 $( ".selector" ).slider( "destroy" );
.disable() 禁用滑块 $( ".selector" ).slider( "disable" );
.enable() 启用滑块 $( ".selector" ).slider( "enable" );
.instance() 检索滑块的实例对象。如果元素没有关联的实例,undefined则返回。与其他方法不同,instance()在滑块插件加载后调用任何元素是安全的 $( ".selector" ).slider( "instance" );
.option(optionName) 获取当前与指定关联的值optionName var isDisabled = $( ".selector" ).slider( "option", "disabled" );
.option() 获取一个对象,该对象包含表示当前滑块选项哈希的键/值对 var options = $( ".selector" ).slider( "option" );
.option(optionName,value) 设置与指定关联的滑块选项的值optionName $( ".selector" ).slider( "option", "disabled", true );
.option(options) 为滑块设置一个或多个选项 $( ".selector" ).slider( "option", { disabled: true } );
.value() 获取滑块的值 var selection = $( ".selector" ).slider( "value" );
.value(value) 设置滑块的值 $( ".selector" ).slider( "value", 55 );
.values() 获取所有句柄的值 var values = $( ".selector" ).slider( "values" );
.values(index) 获取指定句柄的值 var value = $( ".selector" ).slider( "values", 0 );
.values(index, value) 设置指定句柄的值 $( ".selector" ).slider( "values", 0, 55 );
.values(values) 设置指定句柄的值 $( ".selector" ).slider( "values", [ 55, 105 ] );
.widget() 返回jQuery包含滑块的对象 var widget = $( ".selector" ).slider( "widget" );

事件

名称 描述
change(event,ui) 用户滑动手柄后触发,如果值已更改; 或者如果通过该value方法以编程方式更改该值
create(event,ui) 创建滑块时触发
slide(event,ui) 滑动期间每次鼠标移动时触发。事件中提供ui.value的值表示句柄将由于当前移动而具有的值。取消事件将阻止句柄移动,句柄将继续具有其先前的值
start(event,ui) 开始滑动时触发
stop(event,ui) 滑动手柄后触发

事件示例: