Stepper 步进器

介绍

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

引入

在app.json或index.json中引入组件，详细介绍见快速上手。

"usingComponents": {
  "van-stepper": "@vant/weapp/stepper/index"
}

代码演示

基础用法

通过value设置输入值，可以通过change事件监听到输入值的变化。

<van-stepper value="{{ 1 }}" bind:change="onChange" />

Page({
  onChange(event) {
    console.log(event.detail);
  },
});

步长设置

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

<van-stepper value="{{ 1 }}" step="2" />

限制输入范围

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

<van-stepper value="{{ 5 }}" min="5" max="8" />

限制输入整数

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

<van-stepper value="{{ 1 }}" integer />

禁用状态

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

<van-stepper value="{{ 1 }}" disabled />

关闭长按

通过设置long-press属性决定步进器是否开启长按手势。

<van-stepper value="{{ 1 }}" long-press="{{ false }}" />

固定小数位数

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

<van-stepper value="{{ 1 }}" step="0.2" decimal-length="{{ 1 }}" />

异步变更

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

<van-stepper value="{{ value }}" async-change bind:change="onChange" />

Page({
  data: {
    value: 1,
  },
  onChange(value) {
    Toast.loading({ forbidClick: true });
    setTimeout(() => {
      Toast.clear();
      this.setData({ value });
    }, 500);
  },
});

自定义大小

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

<van-stepper value="{{ 1 }}" input-width="40px" button-size="32px" />

API

Props

Events

Slot

外部样式类