# 设置UI引擎前端页面搜索框组件属性
搜索框组件适用于输入内容并执行搜索的场景（如设备编号检索、工艺参数查询、生产工单搜索等）。
#### 前提条件
已在当前页面添加"搜索框"组件，具体操作请参见[为UI引擎前端页面添加物料组件](https://support.huaweicloud.com/usermanual-idme/idme_ui_0016.html)。
#### 配置入口
1. 在页面设计器的中心画布区，单击选中"搜索框"组件。
2. 在右侧设置面板中，单击![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002535447123.png)，即可展开"属性"设置面板。
 
#### 基础信息
| 属性名称     | 说明                                                    | 是否支持变量绑定 |
|:---|:---|:---|
| 绑定值      | 组件的输入值，即用户输入的搜索关键词。该值会自动映射为查询参数，随请求发送至后台接口，用于数据筛选。    | 是        |
| 禁用       | 控制搜索框是否处于禁用状态（不可编辑）。                                  | 是        |
| 占位文本     | 未输入内容时输入框内显示的提示文本，根据搜索内容类型设置，如"请输入设备编号"、"搜索物料名称"等。    | 是        |
| 清空按钮     | 输入内容后，是否在输入框内显示"×"清空按钮。单击可一键清空已输入的搜索内容，提升快速重置搜索条件的效率。 | 是        |
| Enter键触发 | 是否允许用户按键盘"Enter"键触发搜索（需保证组件处于获焦状态），适配快速检索的操作习惯。       | 是        |
   
#### 其他
| 属性名称   | 说明                                                                                                                                                                                                                                                                                                                                                                            | 是否支持变量绑定 |
|:---|:---|:---|
| 元素id值  | 对应HTML标签的"id"属性，同一页面内必须唯一。                                                                                                                                                                                                                                                                                                                                                    | 是        |
| 样式类    | 对应HTML标签的"class"属性，为空格分隔的类名列表，用于自定义组件样式。默认为"component-base-style"。                                                                                                                                                                                                                                                                                                            | 是        |
| ref引用类 | 对应Vue的"ref"属性，用于注册模板引用以访问组件实例方法。 如果为"数据源表单"组件，会自动填充默认值。                                                                                                                                                                                                                                            | 是        |
| 迷你尺寸   | 是否启用迷你模式。 - 开启：组件默认显示为带搜索图标的圆形按钮，单击后展开输入框（适配页面空间紧凑的场景）。  - 关闭：常规矩形搜索框样式。                   | 是        |
| 透明模式   | 是否启用透明模式。 - 开启：组件边框透明，收缩状态下半透明显示（适配带背景图/背景色的界面场景）。  - 关闭：常规不透明边框样式。默认为"false"。   | 是        |