【JIT/极态云】技术文档--筛选器

一、简介

筛选器是一种广泛使用的数据处理工具，主要用于从大量数据中筛选出满足特定条件的数据子集。允许用户自定义搜索参数，例如选择特定日期范围、价格区间或类别等，以展示符合用户需求的结果。当然不同的数据类型所支持的查询条件也有所差异。

总的来说，筛选器的核心功能就是对数据进行有针对性的选择和处理，帮助用户或者系统更有效地管理和利用数据。

二、展示效果

（一）PC 端

在PC端页面中根据筛选器字段，选择筛选项或者直接输入筛选关键字，即可进行数据筛选。

（二）移动端

 

在移动端中，筛选器一般为置顶放置，通过点击下拉输入筛选关键字或者选择筛选项。若需要使用更多的筛选字段，可点击右侧的收起入口。

三、组件数据源

目前数据模型支持选择数据表、聚合表、扩展表模型。

四、组件设计器

（一）配置流程

拖拽【筛选器】组件至页面设计中，并完成组件的初始化配置。筛选器仅需选择数据模型，数据筛选/排序不生效。

在组件设计器中可以对筛选器的筛选字段及布局进行调整，在操作模式上支持简单筛选、复杂筛选、自由筛选三种。

（移动端不支持自由筛选）

针对每个筛选字段，都可以单独配置筛选特性及样式，包括筛选分组的设定及筛选方式。

完成组件的特性配置后，在页面设计中就能看到整个筛选器的展示效果，并可通过“保存并预览”试用。

（二）简单筛选

在简单筛选模式下，可以对各类型数据进行分组并以平铺的形式呈现在页面中。用户无需进行繁琐的输入操作，只需轻松地通过点击预设的各类分组标签，即可实现对海量信息的精准筛选与定位。

1.筛选字段

在简单筛选中，会对部分常用数据类型自动添加筛选字段，并提供内置的推荐筛选分组，如数字/金额的数值型分组，百分比的区间分组等。

同时在此基础上，通过点击“已显示字段”展开关联模型可选的字段来新增筛选字段。再针对每个筛选字段分别配置属性、分组。各个筛选字段之间是“与”的关系，即筛选时所有筛选字段一起生效取交集。

点击每个筛选字段后，会进入到对应字段的配置面板，包括以下配置项：

2.基本配置

• 支持多选

  • 选中状态时，该筛选字段支持多个选项，即各选项间逻辑关系表现为“或”的连接，符合其中一个选项的就会被筛选到。
  • 在未被选中时，则限制该筛选字段仅能选择单个选项。

• 显示“全部”选项

  • 选中状态时，在选项组中默认展示“全部”选项，即不进行筛选，且与其他选项之间互斥。
  • 在未被选中时，不展示“全部”选项。
• 显示标题：选中状态，会正常将字段标题前置显示，且为字段别名显示的前置条件。本属性默认为选中状态。

• 设置字段别名

  • 选中状态，将使用字段别名替代字段标题进行展示。
  • 未被选中时则默认使用字段标题。
• 占比：字段宽度支持设置25%、50%、75%、100%，指代对应筛选字段占筛选器组件的宽度。

3.分组配置

将数据进行精细化分组，无论是处理离散型抑或是连续型变量，都能够实现数据的有序分类与整合。这一过程通常建议将数据划分为3至5个具有代表性的层次区间，每个区间都应设定独特且精准的筛选阈值或条件。

• 选项分组：分组包含三个要素，即分组名称、筛选方式、筛选范围。

  • 选项分组名称，是直接呈现在页面上的选项名，起到顾名思义，快速识别的作用，屏蔽其后复杂的筛选逻辑。选项分组的前后顺序也决定了该选项分组在系统页面中从左到右的排列顺序。

  • 筛选方式，针对每个分组设置指定的筛选条件，需要设定筛选方式。

    • 目前一共有21种筛选方式，其中包括包含任意一个 、包含、 不包含任意一个 、不包含 、等于任意一个 、等于 、不等于任意一个 、不等于 、开头为 、结尾为 、在范围内 、> 、< 、>= 、<= 、属于 、不属于 、为空 、不为空、选中、不选中。
    • 每一种数据类型都有自己对应的筛选方法，并不是都会用到。例如，单行文本、车牌号等有文本特性的多用“包含”、“等于”这种匹配方式的；而对于数字、日期等有数字特性的多用“<”、“>”这种符号运算的方式；
    • 以上筛选方式在各数据类型的介绍文档中均有具体说明。

• 筛选范围，设定分组在指定筛选方式下的范围，支持两种赋值，固定值和变量值。

4.其它

• 默认选中分组：选中状态，可以选择已有选项组中的某一个选项作为默认的筛选选项。

• 支持自定义筛选：选中状态，可以通过选定的默认筛选方式对该字段进行自定义筛选，并支持显示提示文字，引导使用者使用。

  • 具体筛选方式等同于选项组中对每一种选项的配置，只是筛选范围可以灵活变动。

5.移动端差异

在移动端页面中使用简易模式时，需要通过拖动字段列表顺序而改变组件中渲染次序；不同于PC端中直接在页面中直接拖拽字段改变位置。

(三)复杂筛选

复杂筛选相对于简单筛选而言灵活度更高，只需确定筛选字段，筛选方式由使用者自由选择，根据字段自身特性，可选择不同的筛选方式。

复杂筛选新增筛选字段方式与简单筛选相同，也是通过勾选字段的方式，只是会生成每种数据类型相应的自定义筛选，且都会内置一种常用筛选方式作为默认方法。

在复杂筛选的筛选字段配置中也只会提供最简单的“设置字段别名”，其他具体如何筛选由用户在实际使用时灵活改变。

（四）自由筛选

自由筛选是一种完全开放给用户自己配置的操作模式。它在复杂筛选的基础上放开了对于筛选字段的限制，用户可以任意选择筛选字段，同时基于字段选择想要的筛选条件，是灵活度最高的筛选模式。

（五）部分通用配置

在筛选器不同的操作模式中，有一些通用的组件配置，如：

• 快速布局：影响多个筛选字段之间的布局方式，支持一行一列、一行两列、一行三列、一行四列（复杂筛选不支持）四种方式。

• 首次加载进行筛选：选中状态，一般配合默认选中分组使用，可以在页面加载时应用默认配置的筛选条件进行查询，节省常规应用下的操作时间。

五、组件变量

变量title	变量name	读写	值类型	备注说明
筛选条件	filter	可读写	筛选条件

六、组件函数

函数title	函数name	参数	返回值	备注
重置	reset	无	无	将当前筛选条件清空并触发查询

七、组件事件

事件title	事件name	输出参数	备注
查询后	afterFilter	筛选条件：筛选条件filter	筛选条件有变化或查询后触发

八、组件权限

筛选器组件没有请求后端接口，无后端权限控制。

九、使用场景

筛选器在web应用中的使用场景主要包括但不限于数据密集型页面，如报表系统、数据分析平台、电商产品列表页、CRM系统客户信息检索、大型企业内部管理系统等。

例如，在电商平台上，用户可以利用筛选器选择特定价格区间、品牌、商品类别等条件，筛选出符合个人消费偏好的商品； 例如，人力资源部门在处理海量员工信息时，可以通过设定筛选条件（如工龄、职级、所在部门、专业技能等），迅速定位到符合条件的员工记录，极大地简化了人才管理与资源调配的工作流程。

例如，在CRM系统中，销售人员可以根据客户属性（如地区、行业、消费历史、购买意向级别等）进行多维度筛选过滤，从而实现精细化营销，提升销售转化率。

此外，在知识问答社区或学术文献检索系统中，高级筛选功能也极其重要。用户可根据问题类型、发布时间、回答数量、作者影响力等因素进行筛选，以便于获取最具参考价值的问题解答或研究文献，显著提高知识获取与学术研究的效率。

十、注意事项

筛选器中涉及到范围表示的“-”/“~”/“->”，一般是指半开半闭区间，即[a,b)={x|a≤x<b}。

进一步了解极态云，体验产品？

请访问 极态云官网