更新记录

1.3.0(2026-05-08) 下载此版本

【版本更新说明】

  1. 组件升级为 uni_modules 规范,目录调整为 step-input,去掉 uni- 前缀,兼容插件市场发布要求。
  2. 新增并完善双向绑定能力,支持 v-model、:value + @input、modelValue + update:modelValue 多种写法。
  3. 优化步进输入逻辑,支持字符串/数字返回、整数/小数输入、小数位实时限制、最小值/最大值/默认值/步长配置。
  4. 支持长按连续加减,达到最大值或最小值后自动禁用对应操作,并新增 overlimit 边界事件。
  5. 新增 focus、blur、change、overlimit 事件,支持 increase、decrease、setValue、getValue 等 ref 方法调用。
  6. 增强样式可配置能力,支持 label、placeholder、输入值、背景色、图标颜色、图标大小等参数配置。
  7. 新增 labelFontSize、placeholderFontSize、inputFontSize、inputFontWeight、labelGap 等文字与间距控制能力。
  8. 优化布局逻辑,组件宽度 100% 自适应容器,左右图标仅按自身大小占位,其余空间自动分配给输入框,适配不同大小容器使用。
  9. 修复输入框与 placeholder 样式不一致问题,统一字号、字重、行高,默认输入文字调整为 26rpx 且不加粗。
  10. 新增 showMinus、showPlus 参数,支持单独隐藏加号或减号按钮,满足纯输入或局部控制场景

1.2.0(2026-05-08) 下载此版本

【版本更新说明】

  1. 组件升级为 uni_modules 规范,目录调整为 step-input,去掉 uni- 前缀,兼容插件市场发布要求。
  2. 新增并完善双向绑定能力,支持 v-model、:value + @input、modelValue + update:modelValue 多种写法。
  3. 优化步进输入逻辑,支持字符串/数字返回、整数/小数输入、小数位实时限制、最小值/最大值/默认值/步长配置。
  4. 新增强交互能力,支持长按连续加减、边界禁用、focus/blur/change/overlimit 事件,以及 increase/decrease/setValue/getValue 方法。
  5. 增强样式可配置能力,支持标题、placeholder、输入值、背景色、图标颜色、图标大小、标题间距等参数控制。
  6. 重构布局逻辑,组件宽度 100% 自适应容器,左右图标按自身大小占位,剩余空间自动分配给输入框,适配任意大小容器使用。
  7. 修复 placeholder 样式异常问题,统一 placeholder 与输入文字的字号、字重、行高,默认输入文字调整为 26rpx 且不加粗。

1.1.0(2026-05-08) 下载此版本

1.新增图标大小设置 2.组件大小设置

查看更多

平台兼容性

uni-app(3.7.12)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
-
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟

step-input

step-input 是一个适用于 uni-app 的步进输入框组件,支持:

  • 字符串和数字两种返回值类型
  • 整数、小数输入与实时小数位限制
  • 最小值、最大值、默认值、步长控制
  • 长按连续加减
  • focusblurchangeoverlimit 事件
  • 标题颜色、placeholder 颜色、背景颜色、图标颜色自定义

基础使用

<template>
    <step-input
        v-model="price"
        label="价格(USDT)"
        :value-type="'string'"
        :step="0.01"
        :min="0"
        :max="999999.999"
        :precision="2"
        placeholder="请输入价格"
        @input="price = $event"
    />
</template>

双向绑定说明

  • Vue2 / uni-app 传统写法:v-model 等价于 :value + @input
  • Vue3 风格写法:组件同时兼容 modelValueupdate:modelValue
  • 如果你只想手动控制,也可以继续使用 :value="amount"@input="amount = $event"

事件返回

  • focus{ value, event }
  • blur{ value, event }
  • change:当前值
  • overlimit{ type, action, limit, value }

Props

  • value:当前值,支持 StringNumber
  • defaultValue:默认值,仅在 value 为空时生效
  • label:标题文本
  • placeholder:占位文本
  • labelColor:标题颜色
  • labelFontSize:标题字号
  • labelGap:标题与输入值间距
  • placeholderColor:占位文本颜色
  • placeholderFontSize:占位文本字号
  • inputColor:输入值颜色
  • inputFontSize:输入值字号
  • inputFontWeight:输入值字重
  • iconSize:加减图标大小
  • backgroundColor:组件背景色
  • iconColor:加减图标颜色
  • showMinus:是否显示减号按钮
  • showPlus:是否显示加号按钮
  • inputType:输入键盘类型,支持 number / digit
  • valueType:返回值类型,支持 string / number
  • step:步长
  • min:最小值
  • max:最大值
  • precision:小数位限制
  • allowLongPress:是否允许长按连续加减
  • disabled:是否禁用

ref 方法

  • increase():增加一步
  • decrease():减少一步
  • setValue(value):设置当前值
  • getValue():获取当前值

uni_modules 目录

uni_modules/
  step-input/
    components/
      step-input/
        step-input.vue

放在 uni_modules 后,可以直接在页面里使用 <step-input />,不需要再手动 import 注册。

隐私、权限声明

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

仅使用 uni-app 基础组件能力,无额外原生权限申请

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

本插件不采集任何用户数据

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

许可协议

MIT协议

暂无用户评论。