调节器 - Spinner

$.fn.validatebox.defaults.继承,覆盖默认值$.fn.spinner.defaults.

spinner结合了一个可编辑的文本框和两个小按钮,它允许用户从一个范围值选取,类似于combobox,spinner 允许用户输入一个值,但是不会有一个下拉列表它是创建其他spinner 组件的基础spinner 组件,例如:numberspinner, timespinner, 等等.

 

Dependencies

  • validatebox

Usage Example

spinner 应该使用javascript创建,从标记创建是不允许的.


Properties

属性从 validatebox继承, 下面是spinner的新增属性.

Name Type Description Default
width number 这个组件的宽度. auto
value string 初始化值.
min string 最小允许值. null
max string 最大允许值. null
increment number 当点击spinner按钮的时候增加的值. 1
editable boolean 定义用户是否可以直接输入值. true
disabled boolean 定义是否禁用该组件. false
spin function(down) 当用户点击spinner按钮的时候调用的方法.'down'参数指明用户是否点击的down按钮.

Events

Name Parameters Description
onSpinUp none 当用户点击up spinner 按钮的时候触发.
onSpinDown none 当用户点击down spinner按钮的时候触发.

Methods

方法从 validatebox继承,以下是 spinner新增的方法.

Name Parameter Description
options none 返回 options 对象.
destroy none 销毁 spinner 组件.
resize width 重新设置组件的宽度.传入'width'参数重写原始的参数.

示例代码:

$('#ss').spinner('resize');  // 根据原始宽度调整大小
$('#ss').spinner('resize', 200);  //调整大小到新的宽度
enable none 启用组件.
disable none 禁用组件.
getValue none 取得组件值.
setValue value 设置组件值.
clear none 清除组件值.