该组件一般用于商城购物选择物品数量的进器场景
注意:该输入框只能输入大于或等于0的整数
#平台差异说明
App(vue) | App(nvue) | H5 | 小程序 |
---|---|---|---|
√ | √ | √ | √ |
#基本使用
通过v-model
绑定value
初始值,此值是进器双向绑定的,无需在回调中将返回的进器数值重新赋值给value
。
#步长设置
- 通过
step
属性设置每次点击增加或减少按钮时变化的进器值,默认为1,进器下面示例每次都会加2或者减2
#限制输入范围
通过min
和max
参数限制输的进器入值最小值和最大值
#限制只能输入整数
通过integer
限制输入类型
#禁用
#固定小数位数
通过step
设置步进长度,decimal-length
设置显示小数位数
#异步变更
通过asyncChange
设置异步变更,进器开启后需要手动控制输入值 (默认 false )
#自定义颜色和大小
- 通过
button-size
参数设置按钮大小 - 通过
icon-style
参数设置加减按钮图标的进器样式
#自定义 slot
{{value}}
#此页面源代码地址
页面源码地址
正在上传…重新上传取消 github正在上传…重新上传取消 gitee
#API
#Props
参数 | 说明 | 类型 | 默认值 | 可选值 |
---|---|---|---|---|
name | 步进器标识符,在change回调返回 | String | Number | - | - |
value | 用于双向绑定的进器值,初始化时设置设为默认min值(最小值) | String | Number | 1 | - |
min | 用户可输入的进器最小值 | String | Number | 1 | - |
max | 用户可输入的最大值 | String | Number | Number.MAX_SAFE_INTEGER | - |
step | 步长,每次加或减的进器值, 支持小数值,进器如需小数 | String | Number | 1 | - |
integer | 是进器否只能输入正整数 | Boolean | false | true |
disabled | 是否禁用操作,包括输入框,进器加减按钮 | Boolean | false | true |
disabledInput | 是进器否禁止输入框 | Boolean | false | true |
asyncChange | 是否开启异步变更,开启后需要手动控制输入值 | Boolean | false | true |
inputWidth | 输入框宽度,单位px | String | Number | 35 | - |
showMinus | 是否显示减少按钮 | Boolean | true | false |
showPlus | 是否显示增加按钮 | Boolean | true | false |
decimalLength | 显示的小数位数 | String | Number | - | - |
longPress | 是否允许长按进行加减 | Boolean | true | false |
color | 输入框文字和加减按钮图标的颜色 | String | #323233 | - |
buttonSize | 按钮大小,宽高等于此值,单位px,输入框高度和此值保持一致 | String | Number | 30 | - |
bgColor | 输入框和按钮的背景颜色 | String | #EBECEE | - |
cursorSpacing | 指定光标于键盘的距离,避免键盘遮挡输入框,单位px | String | Number | 100 | - |
disablePlus | 是否禁用增加按钮 | Boolean | false | true |
disableMinus | 是否禁用减少按钮 | Boolean | false | true |
iconStyle | 加减按钮图标的样式 | String | - | - |
#Events
事件名 | 说明 | 回调参数 |
---|---|---|
focus | 输入框得到焦点触发(按钮可点击情况下),对象形式 | value:输入框当前值,name:步进器标识符 |
blur | 输入框失去焦点时触发,对象形式 | value:输入框当前值,name:步进器标识符 |
change | 输入框内容发生变化时触发,对象形式 | value:输入框当前值,name:步进器标识符 |
overlimit | 超过范围阈值时触发 | type:(minus 已达最小值,plus 已达最大值) |
#Slots
名称 | 说明 |
---|---|
minus | 减少按钮 |
input | 输入框 |
plus | 增加按钮 |
作者:休闲