1 概述
筛选器组件主要包括以下类型：单选列表、多选列表、单选下拉、多选下拉、单选输入框、多选输入框、日期、年、年季、年月、年周、时间和日期时间，您可根据实际业务场景选择合适的筛选器组件类型。筛选器组件主要包括以下类型：单选下拉树、多选下拉树、单选列表树、多选列表树、单选列表、多选列表、单选下拉、多选下拉、单选输入框、多选输入框、日期、年、年季、年月、年周、时间和日期时间，您可根据实际业务场景选择合适的筛选器组件类型。
本文仅介绍各筛选器类型的特有功能，筛选器组件创建及通用功能详情可参考 创建筛选器组件、筛选器组件基础功能 。
...
列表筛选器包括单选和多选两种形式，一般适用于备选值较少的场景。
2.1 展示效果
| 筛选器类型 | 说明 | 示例效果 | |
|---|---|---|---|
| 单选列表 | 筛选器的备选值以单选列表的形式展示，每次只能选择一个值筛选数据。 |
| |
| 多选列表 | 筛选器的备选值以多选列表的形式展示，每次支持连续选择多个值筛选数据。 |
| |
2.2 选择筛选值
列表筛选器备选值最多只能显示前100行，当数据量超过100行时，建议使用下拉或输入框筛选器。
...
（2）按钮风格样式设置分为：按钮组样式、按钮默认样式和按钮选中样式 三类，包括设置圆角、间隔、宽度、边框等样式。
以多选列表为例，设置项及效果如下图所示：设置项及效果如下图所示：
| 样式 | 设置项 | 效果图 |
|---|---|---|
| 按钮组样式 | 圆角 设置按钮平铺后单行四周的圆角。
|
|
边框 设置按钮平铺后单行的边框样式。
|
| |
高度 设置按钮平铺后单行的高度。
|
| |
| 按钮默认样式 |
按钮风格默认的样式效果。
选项 设置单个按钮的边框、高宽和颜色等。
高亮选项 设置选中按钮时的背景色和文字样式。
间隔 设置按钮和按钮之间的间隔。
|
| |
宽度 设置单个按钮的宽度。
|
| |
背景 设置单个按钮的背景。
|
| |
边框 设置单个按钮的边框样式。
|
| |
圆角 设置单个按钮的四周圆角效果。
|
| |
字体 设置按钮内容的字体样式。
|
| |
| 按钮选中样式 | 背景 设置单个按钮被选中/鼠标移入时的背景。
|
|
字体 设置单个按钮被选中/鼠标移入时的字体样式。
|
|
3 下拉筛选器
下拉筛选器包括单选和多选两种形式，一般适用于备选值较多、控件展示空间较小的场景。
3.1 展示效果
| 筛选器类型 | 说明 | 示例效果 | |
|---|---|---|---|
| 单选下拉 | 筛选器的备选值以单选的下拉框形式展示，每次只能选择一个值筛选数据。 |
| |
| 多选下拉 | 筛选器的备选值以多选的下拉框形式展示，每次支持连续选择多个值筛选数据。 |
| |
3.2 选择筛选值
1、下拉筛选器备选值只显示前100行，100行后的数据可通过搜索选择。
...
输入框筛选器包括单选和多选两种形式，输入框筛选器是通过手动输入关键字去筛选数据，一般适用于备选值较多，且对要筛选的内容比较明确，不需要利用列表/下拉筛选器获取全量信息才能勾选的场景。
4.1 展示效果
| 筛选器类型 | 说明 | 示例效果 | |||
|---|---|---|---|---|---|
| 单选输入框 | 单选输入框筛选器不支持通过逗号、分号等分隔符，分别查询多个值，所有输入内容作为一个整体去过滤数据。 | 下图中，城市筛选器的操作符是 模糊匹配 ，输入关键字 京 ，此时会查询出所有城市名字中含 京 的城市。
| |||
| 多选输入框 | 多选输入框筛选器支持通过换行符、英文逗号分隔符，分别查询多个值。
| 下图中，城市筛选器的操作符是 模糊匹配 ，输入关键字 京,海,南，此时会查询出所有城市名字中含 京,海,南 的城市。
| |||
4.2 属性设置
在组件设置的属性中，可对输入框筛选器修改样式效果，属性设置包括：名称、控件和数据类型。
...
多选输入框特有设置：在筛选器设置中，可对 多选输入框筛选器 设置分隔符，默认“(新文本行)”、“,(逗号)”都勾选，“(新文本行)”不允许取消勾选，“,(逗号)”可以取消勾选。
5 日期类筛选器
一般适用于日期型、日期时间型和时间层次字段的筛选场景。
...
日期类筛选器包括：日期、年、年季、年月、年周、时间和日期时间，根据筛选器类型不同下拉选择不同时间频度。
| 类型 | 说明 | 效果 |
|---|---|---|
| 日期 | 以日期的形式展示，选择日期。 |
|
| 年 | 根据所选的年份频度，自动筛选出对应日期范围内的数据。 |
|
| 年季 | 根据所选的年份和季度，自动筛选出对应日期范围内的数据。 |
|
| 年月 | 根据所选的年份和月份，自动筛选出对应日期范围内的数据。 |
|
| 年周 | 根据所选的年份和周，自动筛选出对应日期范围内的数据。 |
|
| 时间 | 以日期的形式展示，选择时间。 |
|
| 日期时间 | 以日期的形式展示，选择日期和时间。 |
|
5.2 数据格式
日期类筛选器设置的数据格式需要和字段值的数据真实格式保持一致，才能筛选出正确的数据，各筛选器类型默认的数据格式如下所示：
| 筛选器类型 | 默认数据格式 | 示例 |
|---|---|---|
| 日期 | yyyy-MM-dd | 2023-01-01 |
| 年 | yyyy | 2023 |
| 年季 | yyyyQ[1|2|3|4] | 2023Q1 |
| 年月 | yyyy-MM | 202301 |
| 年周 | yyyy-Ww | 2023W31 2023W1 |
| 时间 | HH:mm:ss | 19:08:11 |
| 日期时间 | yyyy-MM-dd HH:mm:ss | 2023-01-01 19:08:11 |
如果默认的数据格式和字段值的数据真实格式不一致时，可在 筛选器设置 中修改。下面通过一个简单的示例演示如何使用筛选器组件的数据格式设置功能。
| 锚 | ||||
|---|---|---|---|---|
|
1、前提条件：
（1）本示例中使用到的数据：wiki示例-产品明细数据.xlsx 。
...
（3）选中年周筛选器组件，在组件数据中点击 筛选器设置 ，设置数据格式为 yyyy-ww ，点击 确定 。
数据格式可选内容是受日期控件类型影响的。
（4）此时再选择2017年第1周，能正常查询2017年第1周的数据。
...
在组件设置的属性中，可对日期类筛选器修改样式效果，属性设置包括：名称和控件，详情可参考 筛选器组件通用样式设置 。
6 日期区间类筛选器
日期区间类型的筛选器，可实现通过1个筛选器进行日期区间的筛选。
| 注意 | ||
|---|---|---|
| ||
1、202505发布的版本中日期区间筛选器为beta版，仅支持“日期”类型、仅支持交互式仪表盘。 2、从交互式仪表盘转入透视分析模式、转入即席查询模式时，会丢弃日期区间筛选器。 3、宏代码、跳转规则功能暂不支持对日期区间筛选器传值。 4、文本组件中获取日期区间筛选器的值为 “开始日期,结束日期”格式。 |
| 类型 | 说明 | 效果 |
|---|---|---|
| 日期 | 以日期的形式展示，选择日期区间。 操作符：支持“介于...之间（闭区间）”，即大于等于且小于等于；以及 “介于...之间（开区间）”，即大于且小于。 |
|
5.2 数据类型
日期区间类筛选器，支持的字段数据类型为 日期、字符串。
5.3 数据格式
当筛选器中的字段数据类型为字符串时，筛选器设置的数据格式需要和字段值的数据真实格式保持一致，才能筛选出正确的数据，各筛选器类型默认的数据格式如下所示：
| 筛选器类型 | 默认数据格式 | 示例 |
|---|---|---|
| 日期 | yyyy-MM-dd | 2023-01-01 |
如果默认的数据格式和字段值的数据真实格式不一致时，可在 筛选器设置 中修改。具体使用请参考日期筛选器示例章节的内容。
5.4 属性设置
在组件设置的属性中，可对日期区间类筛选器修改样式效果，属性设置包括：名称和控件，详情可参考 筛选器组件通用样式设置 。
7 树筛选组件
详情可查看：树筛选组件。
