更新记录

1.0.8(2024-08-23) 下载此版本

修复最小值为0不生效的bug

1.0.7(2024-08-23) 下载此版本

修复指定小数位数修改不成功的bug

1.0.6(2024-08-22) 下载此版本

更新文档

查看更多

平台兼容性

Vue2 Vue3
×
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.1.0 app-vue
钉钉小程序 快手小程序 飞书小程序 京东小程序
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari

r-stepper

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

在线示例 完整文档 完整文档

示例

<template>
  <r-config-provider :themeName="themeName">
    <page-header title="步进器"></page-header>
    <view style="padding: 20rpx 0">
      <r-cell-group inset>
        <r-cell title="基础用法">
          <template #value>
            <r-stepper v-model:value="value" />
          </template>
        </r-cell>

        <r-cell title="步长设置">
          <template #value>
            <r-stepper v-model:value="value" step="2" />
          </template>
        </r-cell>

        <r-cell title="限制输入范围">
          <template #value>
            <r-stepper v-model:value="value2" :min="5" :max="8" />
          </template>
        </r-cell>

        <r-cell title="限制输入整数">
          <template #value>
            <r-stepper v-model:value="value3" integer />
          </template>
        </r-cell>

        <r-cell title="禁用状态">
          <template #value>
            <r-stepper v-model:value="value" disabled />
          </template>
        </r-cell>

        <r-cell title="禁用输入框">
          <template #value>
            <r-stepper v-model:value="value" disable-input />
          </template>
        </r-cell>

        <r-cell title="固定小数位数">
          <template #value>
            <r-stepper v-model:value="value4" step="0.2" :decimal-length="1" />
          </template>
        </r-cell>

        <r-cell title="自定义大小">
          <template #value>
            <r-stepper
              v-model:value="value"
              input-width="40px"
              button-size="32px"
            />
          </template>
        </r-cell>

        <r-cell title="圆角风格">
          <template #value>
            <r-stepper
              v-model:value="value"
              theme="round"
              button-size="22"
              disable-input
            />
          </template>
        </r-cell>
      </r-cell-group>
    </view>
  </r-config-provider>
</template>

<script setup>
import { ref } from "vue";
import useTheme from "@/hooks/useTheme";
const { themeName } = useTheme();
const value = ref(1);
const value2 = ref(5);
const value3 = ref(1);
const value4 = ref(1.0);
</script>

API

Props

参数 说明 类型 默认值 可选值
value 当前输入的值 Number|String
min 最小值 Number 1
max 最大值 Number 999
autoFixed 是否自动校正超出限制范围的数值,设置为 false 后输入超过限制范围的数值将不会自动校正 Boolean true false
defaultValue 初始值 Number | String 1
step 步长,每次点击时改变的值 Number | String 1
name 标识符,通常为一个唯一的字符串或数字,可以在 change 事件回调参数中获取 String | Number
inputWidth 输入框宽度 String 64rpx
buttonSize 按钮大小以及输入框高度 String 56rpx
decimalLength 固定显示的小数位数 Number
theme 样式风格 String round
placeholder 输入框占位提示文字 String
integer 是否只允许输入整数 Boolean true false
disabled 是否禁用步进器 Boolean false true
disablePlus 是否禁用增加按钮 Boolean false true
disableMinus 是否禁用减少按钮 Boolean false true
disableInput 是否禁用输入框 Boolean true true
beforeChange 输入值变化前的回调函数,返回 false 可阻止输入,支持返回 Promise Function
showPlus 是否显示增加按钮 Boolean true false
showMinus 是否显示减少按钮 Boolean true false
showInput 是否显示输入框 Boolean true false
longPress 是否开启长按手势,开启后可以长按增加和减少按钮 Boolean true false
allowEmpty 是否允许输入的值为空,设置为 true 后允许传入空字符串 Boolean false true
themeName r-theme 的主题名称 String default

Events

名称 说明 参数
update:value value 值改变的回调 value
change value 值改变的回调 value
plus 点击增加按钮时触发 -
minus 点击减少按钮时触发 -
overlimit 点击不可用的按钮时触发 -

更多组件,请前往rainui

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问