Spinner（微调）

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

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

依赖关系

• textbox

使用案例

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

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

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

属性

微调控件的属性扩展自validatebox(验证框)，微调控件新增或重写的属性如下：

属性名	属性值类型	描述	默认值
width	number	组件宽度。	auto
height	number	组件高度。	22
value	string	默认值。
min	string	允许的最小值。	null
max	string	允许的最大值。	null
increment	number	在点击微调按钮的时候的增量值。	1
editable	boolean	定义用户是否可以直接输入值到字段。	TRUE
disabled	boolean	定义是否禁用字段。	FALSE
readonly	boolean	定义控件是否为只读。	FALSE
spinAlign	string	定义控件的对齐方式。可用值：'left','right','horizontal','vertical'	right
spin	function(down)	在用户点击微调按钮的时候调用的函数。'down'参数对应用户点击的向下按钮。

事件

事件名	事件参数	描述
onSpinUp	none	在用户点击向上微调按钮的时候触发。
onSpinDown	none	在用户点击向下微调按钮的时候触发。

方法

微调控件的方法扩展自validatebox(验证框)，微调控件新增的方法如下：

方法名	方法参数	描述
options	none	返回属性对象。
destroy	none	销毁微调组件。
resize	width	返回组件宽度。通过'width'参数重写原始宽度。见下方代码示例。
enable	none	启用组件。
disable	none	禁用组件。
getValue	none	获取组件值。
setValue	value	设置组件值。
readonly	mode	启用/禁用只读模式。见下方代码示例。
clear	none	清空组件值。
reset	none	重置组件值。

方法代码示例

resize方法示例：

$('#ss').iSpinner('resize');            // 调整到原始宽度
$('#ss').iSpinner('resize', 200);    // 调整到新宽度

readonly方法示例：

$('#ss').iSpinner('readonly');      // 启用只读模式
$('#ss').iSpinner('readonly', true);    // 启用只读模式
$('#ss').iSpinner('readonly', false);   // 禁用只读模式