当前位置: 当前位置:首页 > 时尚 > NumberBox 步进器 正文

NumberBox 步进器

2024-04-28 23:44:22 来源:口口声声网 作者:探索 点击:534次

NumberBox 步进器

该组件一般用于商城购物选择物品数量的进器场景

注意:该输入框只能输入大于或等于0的整数

#平台差异说明

App(vue)App(nvue)H5小程序

#基本使用

通过v-model绑定value初始值,此值是进器双向绑定的,无需在回调中将返回的进器数值重新赋值给value

#步长设置

  • 通过step属性设置每次点击增加或减少按钮时变化的进器值,默认为1,进器下面示例每次都会加2或者减2

#限制输入范围

通过minmax参数限制输的进器入值最小值和最大值

#限制只能输入整数

通过integer限制输入类型

#禁用

#固定小数位数

通过step设置步进长度,decimal-length设置显示小数位数

#异步变更

通过asyncChange设置异步变更,进器开启后需要手动控制输入值 (默认 false )

#自定义颜色和大小

  • 通过button-size参数设置按钮大小
  • 通过icon-style参数设置加减按钮图标的进器样式

#自定义 slot

#此页面源代码地址

页面源码地址


正在上传…重新上传取消 github正在上传…重新上传取消 gitee

#API

#Props

参数说明类型默认值可选值
name步进器标识符,在change回调返回String | Number--
value用于双向绑定的进器值,初始化时设置设为默认min值(最小值)String | Number1-
min用户可输入的进器最小值String | Number1-
max用户可输入的最大值String | NumberNumber.MAX_SAFE_INTEGER-
step步长,每次加或减的进器值, 支持小数值,进器如需小数String | Number1-
integer是进器否只能输入正整数Booleanfalsetrue
disabled是否禁用操作,包括输入框,进器加减按钮Booleanfalsetrue
disabledInput是进器否禁止输入框Booleanfalsetrue
asyncChange是否开启异步变更,开启后需要手动控制输入值Booleanfalsetrue
inputWidth输入框宽度,单位pxString | Number35-
showMinus是否显示减少按钮Booleantruefalse
showPlus是否显示增加按钮Booleantruefalse
decimalLength显示的小数位数String | Number--
longPress是否允许长按进行加减Booleantruefalse
color输入框文字和加减按钮图标的颜色String#323233-
buttonSize按钮大小,宽高等于此值,单位px,输入框高度和此值保持一致String | Number30-
bgColor输入框和按钮的背景颜色String#EBECEE-
cursorSpacing指定光标于键盘的距离,避免键盘遮挡输入框,单位pxString | Number100-
disablePlus是否禁用增加按钮Booleanfalsetrue
disableMinus是否禁用减少按钮Booleanfalsetrue
iconStyle加减按钮图标的样式String--

#Events

事件名说明回调参数
focus输入框得到焦点触发(按钮可点击情况下),对象形式value:输入框当前值,name:步进器标识符
blur输入框失去焦点时触发,对象形式value:输入框当前值,name:步进器标识符
change输入框内容发生变化时触发,对象形式value:输入框当前值,name:步进器标识符
overlimit超过范围阈值时触发type:(minus已达最小值,plus已达最大值)

#Slots

名称说明
minus减少按钮
input输入框
plus增加按钮

 

 

作者:休闲
------分隔线----------------------------
头条新闻
图片新闻
新闻排行榜