筛选器类型

1 概述

筛选器组件主要包括以下类型：单选列表、多选列表、单选下拉、多选下拉、输入框、日期、年、年季、年月、年周、时间和日期时间，您可根据实际业务场景选择合适的筛选器组件类型。

本文仅介绍各筛选器类型的特有功能，筛选器组件创建及通用功能详情可参考创建筛选器组件、筛选器组件基础功能。

2 列表筛选器

列表筛选器包括单选和多选两种形式，一般适用于备选值较少的场景。

2.1 展示效果

筛选器类型		说明	示例效果
单选列表		筛选器的备选值以单选列表的形式展示，每次只能选择一个值筛选数据。
多选列表		筛选器的备选值以多选列表的形式展示，每次支持连续选择多个值筛选数据。

2.2 选择筛选值

列表筛选器备选值最多只能显示前100行，当数据量超过100行时，建议使用下拉或输入框筛选器。（有BUG，要替换图片）

单选列表选择全部时，是查询所有数据
多选列表选择全选时，因只勾选了前100行的值，所以只查询前100行的值去过滤数据

在 筛选器设置 中可设置是否在备选值中显示 全部/全选 选项，详情可参考筛选器备选值。

2.3 属性设置

在组件设置的属性中，可对列表筛选器修改样式效果，样式设置包括：名称、每行列数、滚动条、风格。

1、名称是筛选器组件的通用设置项，详情可参考筛选器组件通用样式设置。

2、每行列数 是设置备选值列表要分为几列展示，效果如下图所示：

3、滚动条 是指当列表备选值过多时，可设置筛选器组件内部是否显示滚动条。

组件高宽在某些临界值时刚好出现了滚动条，但调整组件高宽比较难设置实现在不同显示设备都不显示滚动条，为了美观可通过此设置项设置隐藏组件内部的滚动条。

4、风格

列表样式筛选器支持设置两种风格：选框和按钮，默认效果为选框。

（1）选框风格支持设置选框颜色和文字样式，以多选列表为例，设置项及效果如下图所示：

（2）按钮风格支持设置圆角、边框和选项等样式，以单选列表为例，设置项及效果如下图所示：

样式	设置项	效果图
默认	按钮风格默认的样式效果。
自定义	圆角设置所有按钮平铺后四周的圆角。
	边框设置所有按钮平铺后整体的边框样式。
	选项设置单个按钮的边框、高宽和颜色等。
	高亮选项设置选中按钮时的背景色和文字样式。

3 下拉筛选器

下拉筛选器包括单选和多选两种形式，一般适用于备选值较多、控件展示空间较小的场景。

3.1 展示效果

筛选器类型		说明	示例效果
单选下拉		筛选器的备选值以单选的下拉框形式展示，每次只能选择一个值筛选数据。
多选下拉		筛选器的备选值以多选的下拉框形式展示，每次支持连续选择多个值筛选数据。

3.2 选择筛选值

1、下拉筛选器备选值只显示前100行，100行后的数据可通过搜索选择。

2、全部

（1）下拉筛选器在 筛选器设置 中可设置在备选值中是否显示全部选项，详情可参考筛选器备选值。

（2）选择全部时，是查询所有数据。

3、部分选择

如果先选择全部，再取消选择某些项，此时下拉筛选器会显示 部分选择 ，代表过滤数据时仅排除这些被取消的项。比如 订单编号 筛选器的操作符是包含，先选择全部，此时查询结果是获取全部数据。再取消选择某些项，此时下拉筛选器显示 部分选择 ，筛选条件是不包含被取消的项。

3.3 属性设置

在组件设置的属性中，可对下拉筛选器修改样式效果，属性设置包括：名称、控件和自定义值。

1、其中名称和控件是筛选器组件的通用设置项，详情可参考筛选器组件通用样式设置。

2、自定义值 指是否允许用户使用自定义的值作为筛选值。

设置为允许时，在筛选器文本框中输入任意一个不存在于备选值中的值，如输入“test数据”，可将所输入文本作为筛选值使用。

4 输入框筛选器

输入框筛选器是通过手动输入关键字去筛选数据，一般适用于备选值较多，且对要筛选的内容比较明确，不需要利用列表/下拉筛选器获取全量信息才能勾选的场景。

4.1 展示效果

下图中，城市筛选器的操作符是 模糊匹配 ，输入关键字京，此时会查询出所有城市名字中含京的城市。

输入框筛选器不支持通过逗号、分号等分隔符，分别查询多个值，所有输入内容作为一个整体去过滤数据。

4.2 属性设置

在组件设置的属性中，可对输入框筛选器修改样式效果，属性设置包括：名称、控件和数据类型。