Vant Stepper 步進(jìn)器

介紹

步進(jìn)器由增加按鈕、減少按鈕和輸入框組成，用于在一定范圍內(nèi)輸入、調(diào)整數(shù)字

引入

import Vue from 'vue';
import { Stepper } from 'vant';

Vue.use(Stepper);

代碼演示

基礎(chǔ)用法

通過(guò)v-model綁定輸入值，可以通過(guò)change事件監(jiān)聽(tīng)到輸入值的變化

<van-stepper v-model="value" />

export default {
  data() {
    return {
      value: 1
    }
  }
}

步長(zhǎng)設(shè)置

通過(guò)step屬性設(shè)置每次點(diǎn)擊增加或減少按鈕時(shí)變化的值，默認(rèn)為1

<van-stepper v-model="value" step="2" />

限制輸入范圍

通過(guò)min和max屬性限制輸入值的范圍

<van-stepper v-model="value" min="5" max="8" />

限制輸入整數(shù)

設(shè)置integer屬性后，輸入框?qū)⑾拗浦荒茌斎胝麛?shù)

<van-stepper v-model="value" integer />

禁用狀態(tài)

通過(guò)設(shè)置disabled屬性來(lái)禁用步進(jìn)器，禁用狀態(tài)下無(wú)法點(diǎn)擊按鈕或修改輸入框

<van-stepper v-model="value" disabled />

禁用輸入框

通過(guò)設(shè)置disabled-input屬性來(lái)禁用輸入框，此時(shí)按鈕仍然可以點(diǎn)擊

<van-stepper v-model="value" disabled-input />

固定小數(shù)位數(shù)

通過(guò)設(shè)置decimal-length屬性可以保留固定的小數(shù)位數(shù)

<van-stepper v-model="value" step="0.2" :decimal-length="1" />

自定義大小

通過(guò)input-width屬性設(shè)置輸入框?qū)挾?，通過(guò)button-size屬性設(shè)置按鈕大小和輸入框高度

<van-stepper v-model="value" input-width="40px" button-size="32px" />

異步變更

如果需要異步地修改輸入框的值，可以設(shè)置async-change屬性，并在change事件中手動(dòng)修改value

<van-stepper
  :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();

        // 注意此時(shí)修改 value 后會(huì)再次觸發(fā) change 事件
        this.value = value;
      }, 500);
    }
  }
}

API

Props

Events