更新时间:2026-03-16 GMT+08:00
分享

设置UI引擎前端页面数字输入框组件属性

数字输入框组件适用于数值精准录入场景,可对录入数值实现严格的步长控制、加减交互、数值范围限制等精细化管理,满足工业场景对数值精度和范围的严苛要求。

前提条件

已在当前页面添加“数字输入框”组件,具体操作请参见为UI引擎前端页面添加物料组件

配置入口

  1. 在页面设计器的中心画布区,单击选中“数字输入框”组件。
  2. 在右侧设置面板中,单击,即可展开“属性”设置面板。

基础信息

属性名称

说明

是否支持变量绑定

绑定值

组件的双向绑定值,也是组件提交给表单的最终数值,支持实时同步录入/调整后的数值。

占位文本

未输入数值时,输入框内显示的提示文本(如“请输入工艺参数的值”)。

内容可清空

控制输入框内容是否允许清空。

  • 开启:可删除所有内容,输入框为空。
  • 关闭:删除内容后自动填充“0”,输入框始终保留数值。

禁用

是否禁用组件。

禁用后输入框不可输入、加减按钮不可单击,无法修改数值。

尺寸

组件整体显示大小,可根据页面布局选择合适的尺寸。

加减按钮

是否显示数值调整的加减控制按钮。

开启后可通过单击按钮快速调整数值,适配快速微调需求。

加减按钮位置

仅当“加减按钮”开启时生效,可选值:

  • 只在右侧:加减按钮并排显示在输入框右侧。
  • 左右两侧:减按钮在左侧、加按钮在右侧。默认为“只在右侧”

精度

数值的小数精度(如设置为2,则保留2位小数)。

注意:受计算机硬件和数值表示的底层原理限制,某些情况下精度可能会丢失(如整数过大或执行某些小数的加减法)。

步长

单击加减按钮时,数值每次变化的大小。

最大数值

用户可输入的最大值,超出范围时会重置为最大值。

最小数值

用户可输入的最小值,超出范围时会重置为最小值。

其他

如下属性适用于UI引擎所有组件,用于精细化控制。

属性名称

说明

是否支持变量绑定

元素id值

对应HTML标签的“id”属性,同一页面内必须唯一。

样式类

对应HTML标签的“class”属性,为空格分隔的类名列表,用于自定义组件样式。默认为“component-base-style”

ref引用类

对应Vue的“ref”属性,用于注册模板引用以访问组件实例方法。

如果为“数据源表单”组件,会自动填充默认值。

相关文档