mirror of
https://gitee.com/vant-contrib/vant-weapp.git
synced 2025-04-06 03:58:05 +08:00
80 lines
2.1 KiB
Markdown
80 lines
2.1 KiB
Markdown
# 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` |
|
||
| show-plus | 是否显示增加按钮 | `Boolean` | `true` |
|
||
| show-minus | 是否显示减少按钮 | `Boolean` | `true` |
|
||
|
||
### Events
|
||
|
||
| 事件名 | 说明 | 回调参数 |
|
||
|-----------|-----------|-----------|
|
||
| bind:change | 当绑定值变化时触发的事件 | event.detail: 当前输入的值 |
|
||
| bind:overlimit | 点击不可用的按钮时触发 | - |
|
||
| bind:plus | 点击增加按钮时触发 | - |
|
||
| bind:minus | 点击减少按钮时触发 | - |
|
||
| bind:focus | 输入框聚焦时触发 | - |
|
||
| bind:blur | 输入框失焦时触发 | - |
|
||
|
||
### 外部样式类
|
||
|
||
| 类名 | 说明 |
|
||
|-----------|-----------|
|
||
| custom-class | 根节点样式类 |
|
||
| input-class | 输入框样式类 |
|
||
| plus-class | 加号按钮样式类 |
|
||
| minus-class | 减号按钮样式类 |
|