---
url: /v6.2/filter-search.md
---
# 文本搜索框

在很多查询系统中，需要根据用户主动输入的信息来查找数据，如快递、外卖、售票、员工系统等。这些场景可以使用文本搜索框来实现。
![](/images/data-analytics/filter/filter-search-001.png)

文本搜索框能够快速筛选出符合输入条件的数据，支持模糊搜索、精确搜索、以分隔符分别搜索等多种搜索方式。

## 添加文本搜索框

在仪表盘中添加文本搜索框。
1.在仪表盘中，点击**新建过滤器**->**过滤器**，创建一个新的过滤器，调整过滤器大小和位置。
![](/images/data-analytics/filter/filter-search-002.png)
2.选择过滤字段所在的数据集，然后拖入需要筛选的字段。
![](/images/data-analytics/filter/filter-search-007.png)

> \[!TIP] 提示
> 文本搜索框支持对文本、数字、时间类型进行搜索

3.设置文本搜索框默认值。
![](/images/data-analytics/filter/filter-search-003.png)

* 自定义文案： 文案指没有输入搜索项时文本搜索框内显示的内容，支持用户自定义或使用默认值。
* 默认搜索内容：设置文本框默认搜索的内容，并展示相应的搜索结果。
* 匹配方式：包括模糊搜索、精确搜索、以分隔符分别搜索。
  * 模糊搜索指使用 like 模糊匹配的方式进行搜索，搜索时仅匹配一个选项。 模糊搜索示例中，`order 00 12`代表查找同时包含`order`、`00`和`12`的订单编号对应的数据信息。
    ![](/images/data-analytics/filter/filter-search-004.png)
  * 精确搜素指精准的搜索相应文本框中的内容。示例中`order 00 12`代表查找订单编号等于`order 00 12`时的数据信息。
    ![](/images/data-analytics/filter/filter-search-005.png)
  * 以分隔符分别搜索指在搜索中可以搜索多个选项，每个选项之间用分隔符分开。示例中`order 00 12`代表查找包含`order`或`00`或`12`的订单编号对应的数据信息。
    ![](/images/data-analytics/filter/filter-search-006.png)
* 分隔符：支持空格、分号、换行三种。 在模糊搜索和以分隔符分别搜索中需要使用分隔符。
* 搜索执行方式：支持使用回车执行搜索和实时搜索。

4.设置文本搜索框样式，包括标题和展示样式。
![](/images/data-analytics/filter/filter-search-008.png)

## 文本搜索框示例

下面是文本搜索框在员工表系统中的应用示例，用户可以通过输入姓名和员工号来查找员工信息。

![](/images/data-analytics/filter/filter-search.gif)

## 文本搜索框使用说明

文本搜索框支持以下功能设置。

1. 通过添加[内部过滤器](filter-setting.md#内部过滤器)，对过滤字段的内容进行控制。
2. 通过[全局设置](filter-setting.md#全局设置)，调整过滤器的层级关系，使过滤器之间相互关联。
3. 可以[移动到侧边栏节](filter-setting.md#侧边栏过滤器)节省画布空间。
4. 可以设置[过滤的图表范围](filter-setting.md#过滤器交互操作)。