---
order: 5
navTitle: 快速搜索
---
# 仪表板组件-快速搜索

快速搜索是一个辅助输入组件，帮助用户在大量的数据中快速定位并选择一条需要的数据，通常用于搜索那些无法全部列出供用户选择的数据，这些数据可能数据量很大、也可能由于安全考虑不希望一次性显示给用户，比如企业名称、疾病编码等，以下方搜索企业名称为例：

![快速搜索](./images/2021-10-25-14-08-33.gif)

示例：[快速搜索组件](https://demo.succbi.com/v5/bi/%E5%BF%AB%E9%80%9F%E6%90%9C%E7%B4%A2%E4%BC%81%E4%B8%9A)

## 使用快速搜索{#use}

使用快速搜索组件时，需要添加**搜索字段**，并搭配展示数据的组件一起使用。如通过企业名称筛选出该企业的基本信息，实现步骤如下：

![操作](./images/2021-10-25-12-08-33.gif)

1. **拖入快速搜索组件**：在**组件区**>**输入**中将**快速搜索**组件拖入到画布中
2. **设置数据**：拖入`企业名称`字段到**属性栏**>**数据**>**字段**中，拖入`企业内部序号`到**属性栏**>**数据**>**搜索字段**中，右键`企业内部序号`，在显示的菜单中，取消**列表中显示**属性的勾选

## 属性介绍{#attribute}

在**属性栏**>**数据**中引入需要的字段信息，即可简单实现快速搜索。下面是对**属性栏**>**数据**处的一些属性介绍：

![属性](./images/2021-10-25-13-45-32.png)

- **字段**：主要用于自动过滤。只支持拖入一个指标，启用自动过滤后，会以**字段**的值作为过滤参数进行数据过滤，在过滤数据时会作用到所有引用了指标的组件。拖入**字段**中的指标会默认同步到**搜索字段**中，可自行去掉
- **搜索字段**：搜索时用于匹配关键字的字段，支持拖入多个指标，为空时默认搜索**字段**中的指标。拖入到**搜索字段**中的指标右键显示的菜单中，增加了**可搜索**，**列表中显示**两个菜单选项，如下
  - **可搜索**：默认勾选，表示搜索可用于匹配关键字
  - **列表中显示**：默认勾选，表示在搜索时该指标的信息会显示在搜索结果列表内