更新记录
1.0.8(2024-08-23)
下载此版本
修复最小值为0不生效的bug
1.0.7(2024-08-23)
下载此版本
修复指定小数位数修改不成功的bug
1.0.6(2024-08-22)
下载此版本
更新文档
查看更多
平台兼容性
App |
快应用 |
微信小程序 |
支付宝小程序 |
百度小程序 |
字节小程序 |
QQ小程序 |
HBuilderX 3.1.0 app-vue |
√ |
√ |
√ |
√ |
√ |
√ |
钉钉小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
√ |
√ |
√ |
√ |
H5-Safari |
Android Browser |
微信浏览器(Android) |
QQ浏览器(Android) |
Chrome |
IE |
Edge |
Firefox |
PC-Safari |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
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