现在位置: 首页 > jQuery EasyUI 教程 > 正文

jQuery EasyUI 表单插件 - Spinner 微调器


jQuery EasyUI 插件 jQuery EasyUI 插件

扩展自 $.fn.validatebox.defaults。通过 $.fn.spinner.defaults 重写默认的 defaults。

微调器(spinner)把可编辑的文本框和两个小按钮结合起来,允许用户从某个范围的值中进行选择。与组合框(combobox)相似,微调器(spinner)允许用户输入一个值,但是它买i有下拉列表。微调器(spinner)是创建其他微调器组件(比如:数值微调器 numberspinner、时间微调器 timespinner,等等)的基础组件。

依赖

  • validatebox

用法

微调器(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 起可用。

jQuery EasyUI 插件 jQuery EasyUI 插件