Input Number 数字输入框
该组件是低代码平台中用于数值输入与调整的表单项,基于 Element Plus 的 <el-input-number> 封装,支持步长控制、精度限制、图标定制及对齐方式,并深度集成表单容器(<el-form>)的数据绑定与校验体系。
基础属性
| 属性 | 类型 | 说明 |
|---|---|---|
减少图标 decreaseIcon | string | 自定义减号按钮图标(如 'ep:minus') |
增加图标 increaseIcon | string | 自定义加号按钮图标(如 'ep:plus') |
前缀图标 prefixIcon | string | 显示在输入框左侧的图标 |
后缀图标 suffixIcon | string | 显示在输入框右侧的图标 |
最小值 min | number | 允许输入的最小数值(默认 0) |
最大值 max | number | 允许输入的最大数值 |
步长 step | number | 每次点击增减按钮的变化量(默认 1) |
精度 precision | number | 数值保留的小数位数(默认 0,即整数) |
是否只能输入步长的倍数 stepStrictly | boolean | 启用后,用户输入值必须为 min + n × step |
是否使用控制按钮 controls | boolean | 显示上下调节按钮(默认开启) |
控制按钮位置 controlsPosition | enum | 可选:默认(左右两侧)、right(右侧)(仅当启用控制按钮时生效) |
输入文本对齐 align | enum | 输入框内文本对齐方式:left、center、right |
是否宽度自适应 fullWidth | boolean | 组件宽度撑满容器 |
输入提示文本 placeholder | string | 未输入时的占位提示文字 |
| 表单项基础配置 | — | 包含标签宽度、布局控制等通用表单项设置(来自 formItemBaseDefine) |
高级属性
| 属性 | 类型 | 说明 |
|---|---|---|
| 表单项高级配置 | — | 包含字段名(prop)、标签文本(label)等核心绑定配置(来自 formItemAdvDefine) |
事件
| 事件 | 触发时机 | 说明 |
|---|---|---|
change | 数值确认后发生变化时 | 对应 Element Plus 的 change 事件 |
