InputNumber 数字输入框
InputNumber 数字输入框,该组件多用于购物车加减商品等场景。
# 支持平台
| App(vue) | App(nvue) | H5 | 小程序 |
|---|---|---|---|
| ✓ | ✓ | ✓ | ✓ |
# 代码演示
部分示例演示,完整使用请参考文档API。
# 基础使用
通过 change 事件获取输入框的值。
<wui-input-number @change="change"></wui-input-number>
# 改变加减号颜色
通过 signColor 属性修改加减号颜色。
<wui-input-number signColor="#FFB703"></wui-input-number>
# 设置最小值和最大值
通过 min 属性设置最小值,max 属性设置最大值。
<wui-input-number :min="2" :max="9"></wui-input-number>
# 设置步长
通过 step 属性设置步长(步长0.1)。
<wui-input-number :step="0.1"></wui-input-number>
# 使用v-model
双向绑定。
<wui-input-number v-model="val"></wui-input-number>
# 自定义加减号
通过 custom 属性设置是否自定义加减号,为true则去除默认加减号,使用插槽自定义。
<wui-input-number custom backgroundColor="#FFF" :size="30" :width="60" margin="0">
<wui-icon name="minussign" :size="48" color="#FFB703"></wui-icon>
<template v-slot:plus>
<wui-icon name="plussign-fill" :size="48" color="#FFB703"></wui-icon>
</template>
</wui-input-number>
# Slots
| 插槽名称 | 说明 |
|---|---|
| default | 左侧内容,自定义减号 |
| plus | 右侧内容,自定义加号 |
# Props
| 属性名 | 类型 | 说明 | 默认值 | 平台差异说明 |
|---|---|---|---|---|
| value | Number, String | 输入框值,vue2使用(vue3请忽略) | 1 | - |
| modelValue | Number, String | 输入框值,vue3使用(vue2使用value) | 1 | 支持情况请参考uni-app官方 (opens new window) |
| type | String | 输入框类型,可选值:number、text(主要用于输入负号小数点) | number | - |
| min | Number | 最小值,支持负数 | 1 | - |
| max | Number | 最大值 | 99 | - |
| step | Number | 每次点击改变的间隔大小 | 1 | - |
| disabled | Boolean | 是否禁用操作 | false | - |
| signWidth | Number, String | 加减号宽度,单位rpx | 24 | - |
| height | Number, String | 输入框高度,单位rpx | 40 | - |
| width | Number, String | 输入框宽度,单位rpx | 80 | - |
| radius | Number, String | 输入框圆角,单位rpx | 8 | - |
| size | Number, String | 输入框字体大小,单位rpx | 28 | - |
| backgroundColor | String | 输入框背景颜色 | #EEEEEE | - |
| color | String | 输入框字体颜色 | #181818 | - |
| margin | Number, String | 输入框margin-left,margin-right值,单位rpx | 16 | - |
| custom | Boolean | 是否自定义加减号,为true则去除默认加减号,使用插槽自定义 | false | - |
| index | Number, String | 索引值,列表中使用 | 0 | - |
| params | Number, String | 自定义参数 | 0 | - |
# Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| @change | 输入框值改变时触发 | { value:输入框值, index:索引值, params:自定义参数 } |
| @input vue2 | 用于组件双向绑定,使用v-model指令即可 | value |
| @update:modelValue vue3 | 用于组件双向绑定,使用v-model指令即可 | modelValue |