用途:为 Make App 记录列表提供筛选能力,覆盖关键字搜索与高级筛选两种模式。
主要能力:search-only 模式通过 compileListFilter({ fields, searchText }) 生成筛选表达式,仅使用包核心编译器,不加载筛选预设。advanced-filter 模式使用 compileListFilter({ fields, searchText, advancedFilter }),并加载包控制器与面板;桌面/平板同时实现工具栏高级筛选与 CanvasTable 表头“按该字段筛选”联动,手机端仅提供顶部工具栏入口与 layout="mobile" 面板,不挂载 CanvasTable 表头。支持实体预设的保存、加载、水合与清除,以及 Service filter.expression 载荷集成、URL 深链回显和权限感知的列表访问门禁。
使用方式:定位宿主 UI 包并安装 @qfei-design/make-app-filter@^1.0.0;手机高级筛选需 @qfei-design/make-app-filter@^1.1.0 与 @qfei-design/make-app-mobile@^0.1.11。高级筛选模式在 UI 入口引入 styles.css 一次。新集成使用核心 API,高级筛选使用 /react 与可选 /adapters/antd。安装须沿用项目既有包管理器与工作区,不重写 lockfile。
限制:不自行实现筛选器、不改写 CEL/DNF、不本地过滤列表;空表达式省略 filter。字段元数据须来自运行时元数据。关联、权限、排序、分组、服务路由等由其他技能负责。部分版本与文档细节暂未提供。