更新记录

0.1.5（2026-08-14） 下载此版本

  • 精简 readme：移除内部开发向内容（设计说明 / 实现细节 / 平台差异实现等），只保留安装、用法、API、主题等用户文档

0.1.3（2026-08-07） 下载此版本

  • 支持 iOS 端：组件为全端公共实现，无端差异代码，iOS 直接可用

0.1.2（2026-07-31） 下载此版本

  • 移除第三方组件库参考表述，完善独立组件文档。
查看更多

平台兼容性

uni-app x(4.25)

Chrome Safari Android iOS 鸿蒙 微信小程序
√ √ √ √ √ √

其他

多语言 暗黑模式 宽屏模式
× √ ×

nax-number-box

uni-app x 步进器（加减数量）。

依赖

  • nax-icon（加减图标）
  • nax-ui-theme（CSS 变量 --nax-*，安装时依赖 / 运行时弱依赖）

基础用法

<nax-number-box v-model="value" @change="onChange"></nax-number-box>

Props

属性 类型 默认 说明
modelValue number 0 当前值（v-model）
min number 0 最小值
max number 999999 最大值
step number 1 步长
integer boolean false 是否仅允许整数
disabled boolean false 整体禁用
disabledInput boolean false 仅禁用中间输入
disablePlus boolean false 禁用加号
disableMinus boolean false 禁用减号
asyncChange boolean false 异步变更：点击后不立刻改内部值，等外部 v-model 回写
longPress boolean true 长按连续加减
size string md sm / md / lg
inputWidth number 0 输入框宽度（px）；0 跟随 size
buttonSize number 0 按钮边长（px）；0 跟随 size
showMinus boolean true 显示减号
showPlus boolean true 显示加号
bgColor string '' 按钮/输入背景；空则主题次级背景
color string '' 文字/图标色；空则主题正文色
cursorSpacing number 100 键盘与光标间距
customClass string '' 根节点扩展 class

Events

事件 说明
update:modelValue v-model
change 值变化（number）
focus 输入框聚焦
blur 输入框失焦（number）
overlimit 触达边界（'minus' / 'plus'）
minus 点击减号
plus 点击加号

Slot

名称 说明
minus 自定义减号内容
plus 自定义加号内容

主题

通过 CSS 变量覆盖：

Token 用途
--nax-color-bg-hover 按压/悬停背景色
--nax-color-bg-secondary 次级背景色
--nax-color-text 主文字色
--nax-color-text-disabled 禁用文字色
--nax-opacity-disabled 禁用透明度

隐私、权限声明

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

无

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

无

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

无

许可协议

MIT协议
评论列表 撰写评论 向官方投诉

暂无用户评论。