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