数据过滤器的特性与用法

用法介绍

创建过滤器

勾选「使用过滤器」选项，下方「加号」按钮 进行过滤器添加；

• 名称做过滤器的管理，必填项；
• 回调字段，即当组件需要接收回调参数时，可在此处进行填写接收（详细使用场景 可见数据交互模块）；
• 编辑器，即用户可在此处编写原生的JS脚本，主要为js函数的使用（需使用者具备一定前端js技术能力）；
• 下方预览即可对执行的语句结果进行预览查看；

过滤器参数介绍

过滤器为两个参数 第一个是data，第二是callbackArgs

data 通常为数据源直接获取的数据内容，可以为静态数据或是api数据，当数据源为 全局数据容器时，可以绑定多个数据源，此时data内容为数组，数组第一项则为第一个数据源，以此类推

callbackArgs 为第二个参数 该参数需要在回调字段中添加要获取的参数，否则无法获取到回调内容，数据结构为对象，内容为集合

注意点：

1. 数据过滤器本质为代码块，代码块内容报错是受到代码编辑器的影响，并不代表代码无法运行 如 ?? 等语法实际中会报错但可以保存并使用

2. 过滤器会接收回调参数，由于回调参数是一个变量，那么输出的结果也存在不确定性，因此结果无法展示输出结果

查看过滤器

1. 此处可以查看全部的过滤器，针对一些通用的改动可以在此修改

特性

通用性

1. 统一处理接口结构 ( 过滤器前置 )

如图是一个比较常见的接口直接获取的数据

添加接口通用处理

首先我们知道过滤器的执行顺序是从上到下，于图中即先加载通用处理 后加载逻辑处理

在实际数据中，data[0].data 才是我们需要的内容
过滤器前置可以将所有的data[0].data 提取出来

如此处理后 接口就无需在每个过滤器中进行解构使用了

2. 特殊要求补上通用处理 ( 过滤器后置 )

如上图：

第一个第三个有添加正负符号的需求，而第二个没有此需求

所以可以在第一个第三个添加上通用的 符号处理过滤器

针对有特殊需要的内容，勾选通用过滤器，例如上图补充正负，以及数据排序 等

执行顺序

以一个数据容器作为数据源为例 数据的流向为

从数据源开始 根据数据过滤器的处理 流向数据回调、自定义事件以及条件等

触发过滤器

1. 组件渲染 - 组件初次渲染的时候会执行一次过滤器 （前提是组件有渲染）
2. 回调改变 - 回调改变会触发过滤器，多次发送同一回调过滤器不会触发
3. 自动更新 - 勾选自动更新也会定时触发过滤器

数据异常

1. return 内容为 空或者undefined 会默认返回空数组 其余内容会正常输出

2. 请不要在过滤器中输出 时间戳、随机数等内容❎

尤其是在输出内容后发送回调、会进入无限月读直至卡死