设置UI引擎前端页面输入框组件属性
输入框组件适用于纯文本内容录入场景，可支持简短文本（如设备编号、工艺编码）或较长文本（如生产备注、故障描述）的输入。
前提条件
已在当前页面添加“输入框”组件，具体操作请参见为UI引擎前端页面添加物料组件。
配置入口
- 在页面设计器的中心画布区，单击选中“输入框”组件。
- 在右侧设置面板中，单击
，即可展开“属性”设置面板。
基础信息
属性名称 | 说明 | 是否支持变量绑定 |
|---|---|---|
绑定值 | 输入框的双向绑定值，用于获取用户输入的文本内容，或向输入框回填预设文本（如工业表单默认值、历史数据回显）。 | 是 |
类型 | 输入框的展示与交互类型，可选值：
| 是 |
行数 | 仅当“类型”为“textarea”时生效，用于设置多行输入框的默认可见行数（如设置为3，则输入框默认展示3行文本高度）。 | 是 |
占位文本 | 输入框未输入时的提示语。 | 是 |
清除按钮 | 是否显示清除内容的按钮。开启后可一键清空已输入内容，提升快速重置输入的效率。 | 是 |
禁用 | 是否禁用组件。禁用后输入框不可输入、不可编辑，仅可展示文本内容（如表单只读状态下的参数展示）。 | 是 |
尺寸 | 调整输入框的整体大小。 | 是 |
其他
属性名称 | 说明 | 是否支持变量绑定 |
|---|---|---|
元素id值 | 对应HTML标签的“id”属性，同一页面内必须唯一。 | 是 |
样式类 | 对应HTML标签的“class”属性，为空格分隔的类名列表，用于自定义组件样式。默认为“component-base-style”。 | 是 |
ref引用类 | 对应Vue的“ref”属性，用于注册模板引用以访问组件实例方法。 如果为“数据源表单”组件，会自动填充默认值。 | 是 |
最大输入长度 | 限制输入框可录入的文本最大字符数。 | 是 |
显示字数统计 | 仅当设置了“最大输入长度”时生效，控制是否显示已输入字数/总字数统计。 开启后在输入框尾部显示当前输入字符数/最大字符数的统计信息，方便用户把控输入长度。 | 是 |
自动聚焦 | 原生浏览器属性，开启后页面加载完成时，该输入框自动获取焦点，适用于表单的首个必填项输入（如登录页面的账号输入框）。 | 是 |
显示密码切换图标 | 仅当“类型”为“password”时生效，控制是否显示密码可见性切换图标。 | 是 |
插槽信息
插槽功能仅对“类型”为“text”的单行输入框生效，用于自定义输入框的前后置或头尾内容，实现更丰富的界面交互效果。
插槽名称 | 说明 | 位置示例 |
|---|---|---|
输入框头部内容 | 在输入框的上方插入自定义内容（如输入提示图标、字段说明标签）。 |
|
输入框尾部内容 | 在输入框的下方插入自定义内容（如格式说明、校验提示文字）。 |
|
输入框前置内容 | 在输入框的左侧插入自定义内容（如单位标识、功能图标）。 |
|
输入框后置内容 | 在输入框的右侧插入自定义内容（如验证按钮、状态图标）。 |
|
