# Stepper 步进器

### 引入

在`app.json`或`index.json`中引入组件，默认为`ES6`版本，`ES5`引入方式参见[快速上手](#/quickstart)

```json
"usingComponents": {
  "van-stepper": "path/to/vant-weapp/dist/stepper/index"
}
```

## 代码演示

### 基础用法

```html
<van-stepper value="{{ 1 }}" bind:change="onChange" />
```

### 禁用状态

通过设置`disabled`属性来禁用 stepper

```html
<van-stepper value="{{ 1 }}" disabled bind:change="onChange" />
```

### 高级用法

默认是每次加减为1，可以对组件设置`step`、`min`、`max`属性

```html
<van-stepper
  value="{{ value }}"
  integer
  min="5"
  max="40"
  step="2"
  bind:change="onChange"
/>
```

### Props

| 参数 | 说明 | 类型 | 默认值 |
|-----------|-----------|-----------|-------------|
| name | 在表单内提交时的标识符 | `String` | - |
| value | 输入值 | `String | Number` | 最小值 |
| min | 最小值 | `String | Number` | `1` |
| max | 最大值 | `String | Number` | - |
| step | 步数 | `String | Number` | `1` |
| integer | 是否只允许输入整数 | `Boolean` | `false` |
| disabled | 是否禁用 | `Boolean` | `false` |
| disable-input | 是否禁用输入框 | `Boolean` | `false` |
| async-change | 异步变更，为 `true` 时input值不变化，仅触发事件 | `Boolean` | `false` |
| input-width | 输入框宽度，须指定单位 | `String` | `30px` |

### Events

| 事件名 | 说明 | 回调参数 |
|-----------|-----------|-----------|
| bind:change | 当绑定值变化时触发的事件 | event.detail: 当前输入的值 |
| bind:overlimit | 点击不可用的按钮时触发 | - |
| bind:plus | 点击增加按钮时触发 | - |
| bind:minus | 点击减少按钮时触发 | - |
| bind:focus | 输入框聚焦时触发 | - |
| bind:blur | 输入框失焦时触发 | - |

### 外部样式类

| 类名 | 说明 |
|-----------|-----------|
| custom-class | 根节点样式类 |
| input-class | 输入框样式类 |
| plus-class | 加号按钮样式类 |
| minus-class | 减号按钮样式类 |