jQuery EasyUI 表单插件 – Slider 滑块

优质
小牛编辑
131浏览
2023-12-01
pre { white-space: pre-wrap; } jQuery EasyUI 插件

通过 $.fn.slider.defaults 重写默认的 defaults。

滑块(slider)允许用户从一个有限的范围内选择一个数值。当沿着轨道移动滑块控件时,将显示一个表示当前值的提示框,用户可通过设置它的属性来自定义滑块。

依赖

  • draggable

用法

当作为一个表单域使用时,从 <input> 标记创建滑块(slider)。

<input value="12"
    data-options="showTip:true,rule:[0,'|',25,'|',50,'|',75,'|',100]">

从 <div> 创建滑块(slider)也是允许的,但是 'value' 属性是无效的。

<div data-options="min:10,max:90,step:10"></div>

变成创建滑块(slider)。

<div id="ss"></div>
$('#ss').slider({
    mode: 'v',
    tipFormatter: function(value){
        return value + '%';
    }
});

属性

名称类型描述默认值
widthnumber滑块(slider)的宽度。auto
heightnumber滑块(slider)的高度。auto
modestring只是滑块(slider)的类型。可能的值:'h'(horizontal)、'v'(vertical)。h
reversedboolean当设置为 true 时,将会对调最小值和最大值的位置。该属性自版本 1.3.2 起可用。false
showTipboolean定义是否显示值信息提示框。false
disabledboolean定义是否禁用滑块(slider)。false
valuenumber默认值。0
minnumber允许的最小值。0
maxnumber允许的最大值。100
stepnumber增加或减少的值。1
rulearray在滑块旁边显示标签,'|' — 值显示线。[]
tipFormatterfunction格式化滑块值的函数。返回作为提示框显示的字符串值。

事件

名称参数描述
onChangenewValue,oldValue当文本域的值改变时触发。
onSlideStartvalue当开始拖拽滑块时触发。
onSlideEndvalue当停止拖拽滑块时触发。
onCompletevalue当滑块的值被用户改变时触发,无论是通过拖拽滑块改变还是通过点击滑块改变都会触发。该事件自版本 1.3.4 起可用。

方法

名称参数描述
optionsnone返回滑块(slider)选项(options)。
destroynone销毁滑块(slider)对象。
resizeparam设置滑块尺寸。'param' 参数包含下列属性:
width:新的滑块宽度
height:新的滑块高度
getValuenone获取滑块(slider)的值。
setValuevalue设置滑块(slider)的值。
clearnone清除滑块(slider)的值。该方法自版本 1.3.5 起可用。
resetnone重置滑块(slider)的值。该方法自版本 1.3.5 起可用。
enablenone启用滑块(slider)组件。
disablenone禁用滑块(slider)组件。
jQuery EasyUI 插件