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