更新记录
1.0.0(2026-07-15)
下载此版本
带加减按钮的数字输入框
平台兼容性
uni-app(3.8.0)
| Vue2 |
Vue2插件版本 |
Vue3 |
Vue3插件版本 |
Chrome |
Chrome插件版本 |
Safari |
Safari插件版本 |
app-vue |
app-vue插件版本 |
app-nvue |
app-nvue插件版本 |
Android |
Android插件版本 |
iOS |
iOS插件版本 |
鸿蒙 |
鸿蒙插件版本 |
| √ |
1.0.0 |
√ |
1.0.0 |
√ |
1.0.0 |
√ |
1.0.0 |
√ |
1.0.0 |
√ |
1.0.0 |
4.4 |
1.0.0 |
12 |
1.0.0 |
√ |
1.0.0 |
| 微信小程序 |
微信小程序插件版本 |
支付宝小程序 |
支付宝小程序插件版本 |
抖音小程序 |
抖音小程序插件版本 |
百度小程序 |
百度小程序插件版本 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
小红书小程序 |
快应用-华为 |
快应用-联盟 |
| √ |
1.0.0 |
√ |
1.0.0 |
√ |
1.0.0 |
√ |
1.0.0 |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
kex-number-box
带加减按钮的数字输入框(uni-app Vue3 / <script setup>)。
支持长按连点、尺寸预设、主题皮肤、小数步进。
本组件面向 Vue3。当前演示工程 vueVersion: "3"。
平台兼容
| App |
H5 |
微信小程序 |
支付宝 |
其它小程序 |
鸿蒙 |
| √ |
√ |
√ |
√ |
√ |
√ |
安装
放入 uni_modules/kex-number-box 后 easycom 自动引入。
基本用法
<template>
<kex-number-box v-model="num" :min="0" :max="99" @change="onChange" />
</template>
<script setup>
import { ref } from 'vue'
const num = ref(1)
const onChange = (val) => {
console.log(val)
}
</script>
进阶用法
<!-- 尺寸 + 主题 + 长按连点 -->
<kex-number-box
v-model="num"
size="large"
theme="primary"
:step="0.1"
:longpress="true"
/>
<!-- 关闭长按 / 禁止手动输入 -->
<kex-number-box v-model="num" :longpress="false" :inputable="false" theme="outline" />
API
Props
| 属性 |
类型 |
默认值 |
说明 |
| modelValue |
Number | String |
min |
v-model 当前值 |
| min |
Number |
0 |
最小值 |
| max |
Number |
100 |
最大值 |
| step |
Number |
1 |
步进,支持小数 |
| disabled |
Boolean |
false |
禁用 |
| inputable |
Boolean |
true |
是否允许键盘输入 |
| size |
String |
medium |
mini / small / medium / large |
| theme |
String |
default |
default / primary / success / warning / error / outline |
| longpress |
Boolean |
true |
是否开启长按连点 |
| longpressDelay |
Number |
350 |
长按后开始连点的延迟(ms) |
| longpressInterval |
Number |
80 |
连点间隔(ms) |
| width |
Number |
跟随 size |
输入框宽度(px) |
| background |
String |
'' |
自定义背景(覆盖主题) |
| color |
String |
'' |
自定义文字色(覆盖主题) |
| disabledColor |
String |
'' |
禁用按钮文字色 |
Events
| 事件 |
说明 |
回调 |
| update:modelValue |
v-model |
Number |
| change |
值变化 |
Number |
| focus / blur |
聚焦失焦 |
event |