Stepper 步进器

引入

基础用法

通过绑定输入值,可以通过change事件监听到输入值的变化

  1. <van-stepper v-model="value" />
  1. export default {
  2. data() {
  3. return {
  4. value: 1,
  5. };
  6. },
  7. };

步长设置

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

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

限制输入范围

通过minmax属性限制输入值的范围

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

禁用状态

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

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

禁用输入框

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

  1. <van-stepper v-model="value" disable-input />

固定小数位数

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

自定义大小

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

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

  1. <van-stepper :value="value" async-change @change="onChange" />
  1. import { Toast } from 'vant';
  2. export default {
  3. return {
  4. value: 1,
  5. };
  6. },
  7. methods: {
  8. onChange(value) {
  9. Toast.loading({ forbidClick: true });
  10. setTimeout(() => {
  11. Toast.clear();
  12. // 注意此时修改 value 后会再次触发 change 事件
  13. this.value = value;
  14. }, 500);
  15. },
  16. },
  17. };

圆角风格

将 theme 设置为 来展示圆角风格的步进器

Props

Events

事件名说明回调参数
change当绑定值变化时触发的事件value: string, detail: { name: string }
overlimit点击不可用的按钮时触发-
plus点击增加按钮时触发-
minus点击减少按钮时触发-
focus输入框聚焦时触发event: Event
blur输入框失焦时触发event: Event

为什么 value 有时候会变成 string 类型?

这是因为用户输入过程中可能出现小数点或空值,比如 1.,这种情况下组件会抛出字符串类型。