ZYSideSlipFilter 侧边栏条件筛选器,支持自定义事件,自定义筛选栏目

2022年01月16日 阅读数:2
这篇文章主要向大家介绍ZYSideSlipFilter 侧边栏条件筛选器,支持自定义事件,自定义筛选栏目,主要内容包括基础应用、实用技巧、原理机制等方面,希望对大家有所帮助。


                                                       ZYSideSlipFilter 侧边栏条件筛选器,支持自定义事件,自定义筛选栏目_自定义




ZYSideSlipFilter

侧边栏条件筛选器,支持自定义事件,自定义筛选栏目,自定义全部。。。  

CocoaPods

 

pod 'ZYSideSlipFilter', '~> 0.2.0'

Features

ZYSideSlipFilter是一个侧边栏条件筛选器,功能固然就是那个,选择条件,保存选择状态,重置条件。即插即拔,基本支持自定义任何内脏,Demo我作成了商城风格,其实怎样用全在于你本身。ZYSideSlipFilter的工做核心是数据源,它贯穿了整个工做流程。 php

如下是Demo作出来的效果,大体使用结构是这样的: ZYSideSlipFilter 侧边栏条件筛选器,支持自定义事件,自定义筛选栏目_自定义_02api

上图中咱们看见的数据、筛选区域、UI结构所有都不是ZYSideSlipFilter决定的,all self-definition自定义。咱们经过数据源(dataList)来跟Filter交流交换数据,包括咱们的筛选条目的cell结构,咱们的筛选条件,默认选择,和用户选择的结果。也就是说这是一个变化的数据源,像是一张调查问卷,进去是干净的,而出来是涂画过的。咱们怎样经过Filter这个中间者去给用户填问卷呢?来看看​​数据源​​的结构图:ide

ZYSideSlipFilter 侧边栏条件筛选器,支持自定义事件,自定义筛选栏目_ide_03

Structure

ZYSideSlipFilterRegionModel和containerCellClass

图看起来有点复杂,不要紧咱们只须要认识最左边的​​ZYSideSlipFilterRegionModel​​,一个RegionModel表明一个筛选区域,也就是说咱们须要在Filter里增长一个筛选区域,就建立一个RegionModel,Filter数据源里放的就是这个东西。而在RegionModel里面,最基本的咱们只须要认识​​containerCellClass​​这个property, 它表明这个这个筛选区域的UI布局和逻辑代码所在的类(TableviewCell), 咱们要求该自定义类继承自​​SideSlipBaseTableViewCell​​, ==自定义筛选区域tableViewCell,建立RegionModel,赋值containerCellClass,放进dataList,咱们本身的Filter就能显示出来了== 布局

配置筛选项

上图中咱们能够看见Demo的3块筛选区域截图,下箭头对应了他们的RegionModel内容,最基本的containerCellClass配置好后,咱们能够用​​regionTitle​​存储区域标题,用​​itemList​​来存储自定义的选项Model,​​isShowAll​​标识着是否展开所有选项,​​selectedItemList​​存储着用户选中的选项Model,这里再提一遍,用户发生交互后,咱们是要修改RegionModel的,用户提交筛选时咱们会拿到这些修改。对于以上这些property咱们不用,或者不知足需求都不要紧,​​customDict​​给你听任何附加内容。学习

自适应cell高度

ZYSideSlipFilter会在每次reloadData时动态适配cell高度,前提是cell内subviews横向纵向都部署好了对tableViewContentView的自动约束,必须是对​​ContentView​​!!,对tableView无效!!若是须要设置固定高度,则能够重写父类SideSlipBaseTableViewCell的​​+ cellHeight​​方法便可。 this

SideSlipFilter数据交流的方法

上面了解完如何去建立本身的Filter后,如下就是主要协同工做的api: spa

ZYSideSlipFilter 侧边栏条件筛选器,支持自定义事件,自定义筛选栏目_数据源_04

Config

配置文件ZYSideSlipFilterConfig


  • FILTER_NAVIGATION_CONTROLLER_CLASS
    Filter的导航控制器Class(构造方法只支持- initWithRootViewController:)3d

  • 各类UI参数code


语言本地化Localizable.strings

目前配置了两个bottomButton的title string,有须要能够在本身项目的.strings文件中配置,不配置则默认为Reset, Commitblog

 

"sZYFilterReset" = "Reset";
"sZYFilterCommit" = "Commit";


Usage

ZYSideSlipFilterController

建立ZYSideSlipFilterController实例,让呼出者controller持有它,这样咱们可以保持着Filter的状态而且可以屡次呼出(咱们要求呼出者必须有navigationController) 

 

self.filterController = [[ZYSideSlipFilterController alloc] initWithSponsor:self                                             resetBlock:^(NSArray *dataList) {    //Reset Data}                   commitBlock:^(NSArray *dataList) {    //Commit Data}];

_filterController.animationDuration = .3f;
_filterController.sideSlipLeading = 0.15*[UIScreen mainScreen].bounds.size.width;
_filterController.dataList = [self packageDataList];


//need navigationBar?
[_filterController.navigationController setNavigationBarHidden:NO];
[_filterController setTitle:@"title"];


就是这样,咱们的filter能够投向使用了吗?并非,最重要的是咱们的数据源dataList。数据源的结构见数据源结构图,ZYSideSlipFilter会按照数据源结构规则去工做起来。 

数据源准备好后, 让Filter显示出来

[_filterController show];

自定义筛选RegionCell

 

@interface Custom***TableViewCell : SideSlipBaseTableViewCell
+ (NSString *)cellReuseIdentifier { //cellReuseIdentifier }

+ (CGFloat)cellHeight {
//option
//you can use autolayout to cellContentView Rather than this func }

+ (instancetype)createCellWithIndexPath:(NSIndexPath *)indexPath { //cell instance object }

- (void)updateCellWithModel:(ZYSideSlipFilterRegionModel **)model indexPath:(NSIndexPath *)indexPath { //update your cell}

- (void)resetData {
//option
//respond while user click resetButton


详细使用方法请参照Demo


Demo自定义Region示意图

ZYSideSlipFilter 侧边栏条件筛选器,支持自定义事件,自定义筛选栏目_ide_05





POPULAR ARTICLES 



 


ZYSideSlipFilter 侧边栏条件筛选器,支持自定义事件,自定义筛选栏目_数据源_06关注本公众号,学习 iOS 开发点击