筛选器组件基础功能

1 概述

本文主要介绍各类筛选器组件的通用基础功能。

2 名称

用于为筛选器添加标签。选中筛选器组件，在组件设置的数据中点击 筛选器设置 ，在筛选器设置的弹窗中进行名称设置，效果如下图所示：

3 筛选字段

在组件查询数据时，使用筛选字段与组件进行联动。比如下图中城市筛选器绑定的筛选字段是 发货城市 ，表格查询数据的结果，受发货城市字段筛选影响。

4 操作符

选择不同的操作符，会生成不同的筛选条件，进而影响最终的查询结果。

1、选中筛选器组件，在组件设置的数据中点击 筛选器设置 ，在筛选器设置的弹窗中进行操作符设置，如下图所示：

2、根据筛选器类型和绑定的字段类型的不同，可选择的操作符类型也不同。操作符的类型与筛选器类型、字段类型存在对应关系，如下表所示：

5 筛选器默认值

通过设置筛选器默认值来控制打开仪表盘时默认筛选哪些数据，默认值设置类型包括列表选择、静态值、保存值、相对值和特殊值。

5.1 设置入口及效果

1、选中筛选器组件，在组件设置的数据中点击 筛选器设置 ，在筛选器设置的弹窗中进行默认值设置。

2、打开仪表盘时，根据设置的筛选器默认值筛选数据。如下图中，今年为2023年，打开仪表盘希望默认查看3年前华南和西南的订单数据。

5.2 列表选择

列表选择支持直接点击选择字段值作为筛选器默认值。

1、列表选择仅支持 字符串 类型的筛选字段。

2、如果筛选字段的总行数超过1000行时，列表选择默认只显示前1000行的字段值。

3、筛选器组件类型为 单选列表、单选下拉和输入框筛选器时，默认值列表选择为单选；筛选器组件类型为  多选列表和多选下拉，默认值列表选择为多选。

5.3 静态值

静态值指手动输入筛选器的默认值。

• 日期类筛选器的静态值为选择日期、时间
• 非日期类筛选器的静态值为输入内容。

5.4 保存值

以当前仪表盘保存时的值作为筛选器下次打开仪表盘时显示的默认值。

5.5 相对值

以当前系统日期为参考点，设置按时间层次前后时间值为默认值。

1、

5.6 特殊值

6 筛选器备选值

对于列表筛选器和下拉筛选器，支持设置筛选器备选值有哪些项。

设置入口：选中筛选器组件，在组件设置的数据中点击 筛选器设置 ，在筛选器设置的弹窗中进行备选值设置。

6.1 全部

1、单选列表、单选下拉和多选下拉筛选器，支持设置是否在备选值列表中显示 全部 选项。选择 全部 时，是查询所有数据。

2、多选列表筛选器支持设置是否在备选值列表中显示 全选 选项。由于列表筛选器备选值最多只能显示前100行备选值，点击选择 全选 时，因只勾选了前100行的值，所以只查询前100行的值去过滤数据。（有BUG，要替换图片）

6.2 选择null筛选数据

列表筛选器和下拉筛选器，如果字段的值中含null、空串时，筛选器备选值列表中将显示 (null) 、 ，并支持选中过滤对应数据。

6.2 列表过滤

筛选数据时，并不希望展开所有字段值内容，

6.3 条件过滤

7 应用于组件逻辑说明

1、相关数据集所有组件：基于筛选器绑定的字段在 联动设置 中寻找联动关系，所有有关系的组件都会被影响。其中联动设置功能详情可参考 联动设置 。

2、此数据集所有组件：所有来源同一个业务数据集的组件会被影响。

3、自定义：自定义勾选需要影响的组件。

• 点击 清除所选组件，可批量清除所有已经勾选的组件。
• 原本的应用范围是 相关数据集所有组件 或 此数据集所有组件，手动勾选或勾除应用的组件后，此时联动应用范围将自动切换成 自定义 。

8 筛选器变换类型

通过变换类型功能，可以变更筛选器组件类型，比如从多选下拉变换为多选列表，入口和效果如下图所示：

9 样式设置

在组件设置的属性中，可对筛选器组件的名称和控件样式进行设置。本章节仅介绍通用的筛选器样式设置项，各类筛选器的特殊样式设置在对应筛选器类型的文档中单独说明。

名称中各配置项说明如下：

配置项	说明
名称	设置控件左侧标签的内容，默认内容为空。
字体样式	设置名称内容的字体样式：字体类型、大小、加粗、斜体、下划线、颜色。
边距	设置名称左右边距的大小。 名称到组件左边框的距离=组件左边距+名称左边距，组件左边距功能详情可参考 组件属性 。 名称到筛选器控件框的距离=名称右边距

控件中各配置项及效果如下：