介绍

步进器由增加按钮、减少按钮和输入框组成，用于在一定范围内输入、调整数字

引入import Vue from 'vue';

import { Stepper } from 'vant';

Vue.use(Stepper);

代码演示

基础用法

通过v-model绑定输入值，可以通过change事件监听到输入值的变化export default {

data() {

return {

value: 1

}

}

}

步长设置

通过step属性设置每次点击增加或减少按钮时变化的值，默认为1

限制输入范围

通过min和max属性限制输入值的范围

限制输入整数

设置integer属性后，输入框将限制只能输入整数

禁用状态

通过设置disabled属性来禁用步进器，禁用状态下无法点击按钮或修改输入框

禁用输入框

通过设置disabled-input属性来禁用输入框，此时按钮仍然可以点击

固定小数位数

通过设置decimal-length属性可以保留固定的小数位数

自定义大小

通过input-width属性设置输入框宽度，通过button-size属性设置按钮大小和输入框高度

异步变更

如果需要异步地修改输入框的值，可以设置async-change属性，并在change事件中手动修改value

:value="value"

async-change

@change="onChange"

/>import { Toast } from 'vant';

export default {

data() {

return {

value: 1

}

},

methods: {

onChange(value) {

Toast.loading({ forbidClick: true });

setTimeout(() => {

Toast.clear();

// 注意此时修改 value 后会再次触发 change 事件

this.value = value;

}, 500);

}

}

}

API

Props参数说明类型默认值v-model当前输入值number | string-

min最小值number | string1

max最大值number | string-

default-value初始值，当 v-model 为空时生效number | string1

step步长，每次点击时改变的值number | string1

name v2.2.11标识符，可以在change事件回调参数中获取number | string-

input-width输入框宽度，默认单位为pxnumber | string32px

button-size v2.0.5按钮大小以及输入框高度，默认单位为pxnumber | string28px

decimal-length v2.2.1固定显示的小数位数number | string-

integer是否只允许输入整数booleanfalse

disabled是否禁用步进器booleanfalse

disable-plus v2.2.16是否禁用增加按钮booleanfalse

disable-minus v2.2.16是否禁用减少按钮booleanfalse

disable-input是否禁用输入框booleanfalse

async-change是否开启异步变更，开启后需要手动控制输入值booleanfalse

show-plus v2.1.2是否显示增加按钮booleantrue

show-minus v2.1.2是否显示减少按钮booleantrue

long-press v2.4.3是否开启长按手势booleantrue

Events事件名说明回调参数change当绑定值变化时触发的事件value: 当前组件的值, detail: 额外信息，包含 name 的字段

overlimit点击不可用的按钮时触发-

plus点击增加按钮时触发-

minus点击减少按钮时触发-

focus输入框聚焦时触发event: Event

blur输入框失焦时触发event: Event