Stepper 步进器
引入
基础用法
通过绑定输入值,可以通过change
事件监听到输入值的变化
<van-stepper v-model="value" />
export default {
data() {
return {
value: 1,
};
},
};
步长设置
通过step
属性设置每次点击增加或减少按钮时变化的值,默认为1
<van-stepper v-model="value" step="2" />
限制输入范围
通过min
和max
属性限制输入值的范围
<van-stepper v-model="value" integer />
禁用状态
通过设置disabled
属性来禁用步进器,禁用状态下无法点击按钮或修改输入框
<van-stepper v-model="value" disabled />
禁用输入框
通过设置disable-input
属性来禁用输入框,此时按钮仍然可以点击
<van-stepper v-model="value" disable-input />
固定小数位数
通过设置decimal-length
属性可以保留固定的小数位数
自定义大小
<van-stepper v-model="value" input-width="40px" button-size="32px" />
如果需要异步地修改输入框的值,可以设置属性,并在change
事件中手动修改value
<van-stepper :value="value" async-change @change="onChange" />
import { Toast } from 'vant';
export default {
return {
value: 1,
};
},
methods: {
onChange(value) {
Toast.loading({ forbidClick: true });
setTimeout(() => {
Toast.clear();
// 注意此时修改 value 后会再次触发 change 事件
this.value = value;
}, 500);
},
},
};
圆角风格
将 theme 设置为 来展示圆角风格的步进器
Props
Events
事件名 | 说明 | 回调参数 |
---|---|---|
change | 当绑定值变化时触发的事件 | value: string, detail: { name: string } |
overlimit | 点击不可用的按钮时触发 | - |
plus | 点击增加按钮时触发 | - |
minus | 点击减少按钮时触发 | - |
focus | 输入框聚焦时触发 | event: Event |
blur | 输入框失焦时触发 | event: Event |
为什么 value 有时候会变成 string 类型?
这是因为用户输入过程中可能出现小数点或空值,比如 1.
,这种情况下组件会抛出字符串类型。