微调器(spinner)把可编辑的文本框和两个小按钮结合起来,允许用户从某个范围的值中进行选择。与组合框(combobox)相似,微调器(spinner)允许用户输入一个值,但是它买i有下拉列表。微调器(spinner)是创建其他微调器组件(比如:数值微调器 numberspinner、时间微调器 timespinner,等等)的基础组件。
微调器(spinner)应该使用 javascript 进行创建。从标记创建是不允许的。
<input id="ss" value="2">
$('#ss').spinner({ required:true, increment:10 });
该属性扩展自验证框(validatebox),下面是为微调器(spinner)添加的属性。
名称 | 类型 | 描述 | 默认值 |
---|---|---|---|
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 |
spin | function(down) | 当用户点击微调按钮时调用的函数。'down' 参数指示用户是否点击了向下微调按钮。 |
名称 | 参数 | 描述 |
---|---|---|
onSpinUp | none | 当用户点击向上微调按钮时触发。 |
onSpinDown | none | 当用户点击向下微调按钮时触发。 |
该方法扩展自验证框(validatebox),下面是为微调器(spinner)添加的方法。
名称 | 参数 | 描述 |
---|---|---|
options | none | 返回选项(options)对象。 |
destroy | none | 销毁微调器(spinner)组件。 |
resize | width | 重置组件的宽度。通过传递 'width' 参数来重写初始宽度。 代码实例: $('#ss').spinner('resize'); // resize with original width $('#ss').spinner('resize', 200); // resize with new width |
enable | none | 启用组件。 |
disable | none | 禁用组件。 |
getValue | none | 获取组件的值。 |
setValue | value | 设置组件的值。 |
clear | none | 清除组件的值。 |
reset | none | 重置组件的值。该方法自版本 1.3.2 起可用。 |