# 搜索框

来源快照：`result_data_new_260518.json`

- 来源 ID：`1184672166507061301`
- 模块：低代码平台e-builder
- 目录：页面引擎 - 页面设计器 - 页面组件 - 基础组件 - 基础组件/数据展示类
- space ID：`1157961794811633670`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 搜索框

## 一、功能背景及价值用途

在移动端中，搜索框作为一个可与列表组件配合的组件，能基于用户输入的关键词实时刷新过滤数据，还可触发自定义动作，满足用户精准定位数据的需求，提高工作效率并优化用户体验。

## 二、功能概述

搜索框可指定列表并设置过滤条件，实现列表数据筛选功能，并且支持自定义搜索动作以及扫码输入和历史搜索功能，此外，还可以自定义按钮，丰富业务功能

## 三、使用说明

### 1、功能入口

移动端-设计器左侧“基础组件/数据展示类”分类下选中搜索框组件，在右侧配置面板操作相关配置。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1160551265114808357&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 2、基础配置

搜索提示：可配置搜索框提示语

扫码输入：支持扫码输入内容（默认开启）

历史搜索： 支持历史搜索记录（默认开启）

### 3、搜索设置

#### 3.1、搜索动作-刷新组件

可选择指定页面中的列表相关组件， 并设置过滤条件， key为当前搜索值

![](https://weapp.eteams.cn/papi/file/preview?fileId=1160550796815302834&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 3.2、搜索动作-自定义

可自定义配置搜索事件

### 4、自定义按钮

可配置搜索框自定义按钮， 支持整体对齐方式、显示类型、内容设置、事件动作、动态显隐以及样式设置

![](https://weapp.eteams.cn/papi/file/preview?fileId=1160549933689520248&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 四、上下游关联功能点

事件配置参考文档

[https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?freepass_doc=1&id=1159192088358584536&space_id=1157961794811633670](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?freepass_doc=1&id=1159192088358584536&space_id=1157961794811633670)
