滑动型输入器,展示当前值和可选范围,当用户需要在数值区间/自定义区间内进行选择时使用
默认
范围滑块
自定义手柄
多个滑块
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) | 滑动手柄后触发 |
事件示例: