更新记录
1.0.9(2025-10-30) 下载此版本
fix: 组件主题
1.0.8(2024-08-23) 下载此版本
修复最小值为0不生效的bug
1.0.7(2024-08-23) 下载此版本
修复指定小数位数修改不成功的bug
查看更多平台兼容性
uni-app(4.34)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 | 
|---|---|---|---|---|---|---|---|---|
| × | √ | √ | √ | √ | √ | √ | √ | √ | 
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 | 
|---|---|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | 
其他
| 多语言 | 暗黑模式 | 宽屏模式 | 
|---|---|---|
| × | √ | × | 
r-stepper
r-stepper 是uniapp 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

                                                                    
                                                                        收藏人数:
                                    
                                                                                https://gitee.com/uv86e/rainui.git
                                    
                                                        下载插件并导入HBuilderX
                                                    
                                            下载示例项目ZIP
                                        
                                        赞赏(0)
                                    
                                            
                                            
 下载 1851
                
 赞赏 11
                
            
                    下载 10686704 
                
                        赞赏 1797 
                    
            
            
            
            
            
            
            
            
            
            
            
            
            
            
                        
                                赞赏
                            
            
京公网安备:11010802035340号