更新时间：2026-03-16 GMT+08:00
设置UI引擎前端页面搜索框组件属性
搜索框组件适用于输入内容并执行搜索的场景（如设备编号检索、工艺参数查询、生产工单搜索等）。
前提条件
已在当前页面添加“搜索框”组件，具体操作请参见为UI引擎前端页面添加物料组件。
配置入口
- 在页面设计器的中心画布区，单击选中“搜索框”组件。
- 在右侧设置面板中，单击
，即可展开“属性”设置面板。
基础信息
属性名称 | 说明 | 是否支持变量绑定 |
|---|---|---|
绑定值 | 组件的输入值，即用户输入的搜索关键词。该值会自动映射为查询参数，随请求发送至后台接口，用于数据筛选。 | 是 |
禁用 | 控制搜索框是否处于禁用状态（不可编辑）。 | 是 |
占位文本 | 未输入内容时输入框内显示的提示文本，根据搜索内容类型设置，如“请输入设备编号”、“搜索物料名称”等。 | 是 |
清空按钮 | 输入内容后，是否在输入框内显示“×”清空按钮。单击可一键清空已输入的搜索内容，提升快速重置搜索条件的效率。 | 是 |
Enter键触发 | 是否允许用户按键盘“Enter”键触发搜索（需保证组件处于获焦状态），适配快速检索的操作习惯。 | 是 |
其他
属性名称 | 说明 | 是否支持变量绑定 |
|---|---|---|
元素id值 | 对应HTML标签的“id”属性，同一页面内必须唯一。 | 是 |
样式类 | 对应HTML标签的“class”属性，为空格分隔的类名列表，用于自定义组件样式。默认为“component-base-style”。 | 是 |
ref引用类 | 对应Vue的“ref”属性，用于注册模板引用以访问组件实例方法。 如果为“数据源表单”组件，会自动填充默认值。 | 是 |
迷你尺寸 | 是否启用迷你模式。
| 是 |
透明模式 | 是否启用透明模式。
| 是 |
父主题：设置UI引擎前端页面组件属性
