Stepper 步进器

介绍

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

基础用法

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

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

import { ref } from 'vue';
const value = ref(1);

步长设置

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

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

限制输入范围

通过 min 和 max 属性限制输入值的范围，默认超出范围后会自动校正最大值或最小值，通过 auto-fixed 可以关闭自动校正。

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

限制输入整数

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

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

禁用状态

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

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

禁用输入框

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

<z-stepper v-model="value" disable-input />

固定小数位数

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

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

自定义大小

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

<z-stepper v-model="value" input-width="80rpx" button-size="64rpx" />

异步变更

通过 before-change 属性可以在输入值变化前进行校验和拦截。

<z-stepper v-model="value" :before-change="beforeChange" />

import { ref } from 'vue'
import { useToast } from '../../uni_modules/zebra-ui'
const toast = useToast()
const beforeChange = () => {
  toast.showLoadingToast({ forbidClick: true })

  return new Promise((resolve) => {
    setTimeout(() => {
      toast.closeToast()
      resolve(true)
    }, 1000)
  })
}

圆角风格

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

<z-stepper v-model="value" theme="round" button-size="22" disable-input />

Props

Events

样式变量

组件提供了下列 CSS 变量，可用于自定义样式，使用方法请参考 ConfigProvider 组件。