Vant Stepper 步進器

介紹

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

引入

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

Vue.use(Stepper);

代碼演示

基礎用法

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

<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" min="5" max="8" />

限制輸入整數(shù)

設置integer屬性后，輸入框將限制只能輸入整數(shù)

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

禁用狀態(tài)

通過設置disabled屬性來禁用步進器，禁用狀態(tài)下無法點擊按鈕或修改輸入框

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

禁用輸入框

通過設置disabled-input屬性來禁用輸入框，此時按鈕仍然可以點擊

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

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

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

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

自定義大小

通過input-width屬性設置輸入框寬度，通過button-size屬性設置按鈕大小和輸入框高度

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

異步變更

如果需要異步地修改輸入框的值，可以設置async-change屬性，并在change事件中手動修改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();

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

API

Props

Events