调节器 - 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'); // 根据原始宽度调整大小 |
| enable | none | 启用组件. |
| disable | none | 禁用组件. |
| getValue | none | 取得组件值. |
| setValue | value | 设置组件值. |
| clear | none | 清除组件值. |