顶部广告位

Spinner(微调)

扩展自$.fn.validatebox.defaults。使用$.fn.spinner.defaults重写默认值对象。

微调控件结合了一个可编辑文本框和2个小按钮让用户选择一个值的范围。和下拉列表框类似,微调控件允许用户输入值,但是没有下拉列表。微调控件是创建其他高级微调控件的基础控件,比如:numberspinner, timespinner等。

依赖关系

textbox

示例

只能使用Javascript创建微调控件。标签创建是无效的。

<input id="ss" value="2">

$('#ss').spinner({    
      required:true,    
      increment:10    
  });

属性

属性名 属性值类型 描述 默认值
width number 组件宽度。 auto
height number 组件高度。(该属性自1.3.2版开始可用) 22
value string 默认值。
min string 允许的最小值。 null
max string 允许的最大值。 null
increment number 在点击微调按钮的时候的增量值。 1
editable boolean 定义用户是否可以直接输入值到字段。 true
disabled boolean 定义是否禁用字段。 false
readonly boolean 定义控件是否为只读。(该属性自1.3.6版开始可用) false
spin function(down) 在用户点击微调按钮的时候调用的函数。'down'参数对应用户点击的向下按钮。

事件

事件名 事件参数 描述
onSpinUp none 在用户点击向上微调按钮的时候触发。
onSpinDown none 在用户点击向下微调按钮的时候触发。
onChange none 在改变当前值的时候触发。(该事件自1.3.6版开始可用)

方法

方法名 方法参数 描述
options none 返回属性对象。
destroy none 销毁微调组件。
resize width 返回组件宽度。通过'width'参数重写原始宽度。

代码示例:

$('#ss').spinner('resize');            // 调整到原始宽度
$('#ss').spinner('resize', 200);    // 调整到新宽度
enable none 启用组件。
disable none 禁用组件。
getValue none 获取组件值。
setValue value 设置组件值。
readonly mode

启用/禁用只读模式。(该方法自1.3.6版开始可用)

代码示例:

$('#ss').spinner('readonly');		// 启用只读模式
$('#ss').spinner('readonly', true);	// 启用只读模式
$('#ss').spinner('readonly', false);	// 禁用只读模式
clear none 清空组件值。
reset none 重置组件值。(该方法自1.3.2版开始可用)

鄂ICP备16023636号 © 2017 菜鸟程序员