Skip to content

Input Number 数字输入框

该组件是低代码平台中用于数值输入与调整的表单项,基于 Element Plus 的 <el-input-number> 封装,支持步长控制、精度限制、图标定制及对齐方式,并深度集成表单容器(<el-form>)的数据绑定与校验体系。

基础属性

属性类型说明
减少图标 decreaseIconstring自定义减号按钮图标(如 'ep:minus'
增加图标 increaseIconstring自定义加号按钮图标(如 'ep:plus'
前缀图标 prefixIconstring显示在输入框左侧的图标
后缀图标 suffixIconstring显示在输入框右侧的图标
最小值 minnumber允许输入的最小数值(默认 0
最大值 maxnumber允许输入的最大数值
步长 stepnumber每次点击增减按钮的变化量(默认 1
精度 precisionnumber数值保留的小数位数(默认 0,即整数)
是否只能输入步长的倍数 stepStrictlyboolean启用后,用户输入值必须为 min + n × step
是否使用控制按钮 controlsboolean显示上下调节按钮(默认开启)
控制按钮位置 controlsPositionenum可选:默认(左右两侧)、right(右侧)(仅当启用控制按钮时生效)
输入文本对齐 alignenum输入框内文本对齐方式:leftcenterright
是否宽度自适应 fullWidthboolean组件宽度撑满容器
输入提示文本 placeholderstring未输入时的占位提示文字
表单项基础配置包含标签宽度、布局控制等通用表单项设置(来自 formItemBaseDefine

高级属性

属性类型说明
表单项高级配置包含字段名(prop)、标签文本(label)等核心绑定配置(来自 formItemAdvDefine

事件

事件触发时机说明
change数值确认后发生变化时对应 Element Plus 的 change 事件