WMZDropDownMenu
实现功能
- 组合自定义功能
- 支持自定义多选|单选|复选
- 支持自定义弹出的动画 (目前已实现向下,向左全屏,向右全屏,拼多多对话框弹出,boss直聘全屏弹出)
- 支持自定义tableView/collectionView头尾视图
- 支持自定义全局头尾视图
- 支持自定义collectionCell/tableViewCell视图
- 支持自定义标题
- 支持自定义点击回收视图
- 支持自定义回收列表
- 支持任意级的联动(由于数据比较庞杂,暂时自动适配不了无限级的联动,所以需要你调用一个方法更新数据传给我,详情看Demo)
- 支持嵌套使用,即两个筛选菜单可以连着使用
- 支持放在放在任意视图上
- 支持控制器消失自动关闭视图,无须再控制器消失方法里手动关闭
- 链式实现所有配置的自定义修改 (总之,你想要的基本都有,不想要的也有)
下一步 优化使用,增加自定义View的支持 --- 已完成
#目前已经用这控件实现的效果图
注意:如果弹出的视图的y值不准确 你可以手动设置menu的menuOrignY属性
也可以设置wPopOraignY属性
也可以在新增的代理 - (CGFloat)popFrameY; 设置 (1.0.8后才有)
app筛选菜单 | 图片 |
---|---|
仿闲鱼筛选菜单 | |
仿美团筛选菜单 | |
饿了么筛选菜单 | |
京东筛选菜单 | |
拼多多筛选菜单 | |
简书筛选菜单 | |
赶集网筛选菜单 | |
美团外卖筛选菜单 | |
Boss直聘筛选菜单 | |
唯品会筛选菜单 | |
一淘筛选菜单 |
#我手机只有这么一些app了。。~ ~ 总之,目前的app的筛选样式几乎都能实现,当然细节要自己去调
用法(组装全在一些代理里,代理方法可能有点多~ ~,不过只有两个是必实现的,其他的都是可选的)
WMZDropMenuDelegate
@required 一定实现的方法
*/
- (NSArray*)titleArrInMenu:(WMZDropDownMenu *)menu;
/*
*返回WMZDropIndexPath每行 每列的数据
*/
- (NSArray*)menu:(WMZDropDownMenu *)menu
dataForRowAtDropIndexPath:(WMZDropIndexPath*)dropIndexPath;
@optional 可选实现的方法
/*
*返回setion行标题有多少列 默认1列
*/
- (NSInteger)menu:(WMZDropDownMenu *)menu numberOfRowsInSection:
(NSInteger)section;
/*
*自定义tableviewCell内容 默认WMZDropTableViewCell 如果要使用默认的
cell返回 nil
*/
- (UITableViewCell*)menu:(WMZDropDownMenu *)menu
cellForUITableView:(WMZDropTableView*)tableView AtIndexPath:
(NSIndexPath*)indexpath dataForIndexPath:(WMZDropTree*)model;
/*
*自定义tableView headView
*/
- (UITableViewHeaderFooterView*)menu:(WMZDropDownMenu *)menu
headViewForUITableView:(WMZDropTableView*)tableView
AtDropIndexPath:(WMZDropIndexPath*)dropIndexPath;
/*
*自定义tableView footView
*/
- (UITableViewHeaderFooterView*)menu:(WMZDropDownMenu *)menu
footViewForUITableView:(WMZDropTableView*)tableView
AtDropIndexPath:(WMZDropIndexPath*)dropIndexPath;
/*
*自定义collectionViewCell内容
*/
- (UICollectionViewCell*)menu:(WMZDropDownMenu *)menu
cellForUICollectionView:(WMZDropCollectionView*)collectionView
AtDropIndexPath:(WMZDropIndexPath*)dropIndexPath AtIndexPath:
(NSIndexPath*)indexpath dataForIndexPath:(WMZDropTree*)model;
/*
*自定义collectionView headView
*/
- (UICollectionReusableView*)menu:(WMZDropDownMenu *)menu
headViewForUICollectionView:(WMZDropCollectionView*)collectionView
AtDropIndexPath:(WMZDropIndexPath*)dropIndexPath AtIndexPath:
(NSIndexPath*)indexpath;
/*
*自定义collectionView footView
*/
- (UICollectionReusableView*)menu:(WMZDropDownMenu *)menu
footViewForUICollectionView:(WMZDropCollectionView*)collectionView
AtDropIndexPath:(WMZDropIndexPath*)dropIndexPath AtIndexPath:
(NSIndexPath*)indexpath;
/*
*headView标题
*/
- (NSString*)menu:(WMZDropDownMenu *)menu
titleForHeadViewAtDropIndexPath:(WMZDropIndexPath*)dropIndexPath;
/*
*footView标题
*/
- (NSString*)menu:(WMZDropDownMenu *)menu
titleForFootViewAtDropIndexPath:(WMZDropIndexPath*)dropIndexPath;
/*
*返回WMZDropIndexPath每行 每列 indexpath的cell的高度 默认35
*/
- (CGFloat)menu:(WMZDropDownMenu *)menu heightAtDropIndexPath:
(WMZDropIndexPath*)dropIndexPath AtIndexPath:
(NSIndexPath*)indexpath;
/*
*自定义headView高度 collectionView默认35
*/
- (CGFloat)menu:(WMZDropDownMenu *)menu
heightForHeadViewAtDropIndexPath:(WMZDropIndexPath*)dropIndexPath;
/*
*自定义footView高度
*/
- (CGFloat)menu:(WMZDropDownMenu *)menu
heightForFootViewAtDropIndexPath:(WMZDropIndexPath*)dropIndexPath;
#pragma -mark 自定义用户交互的每行的头尾视图
/*
*自定义每行全局头部视图 多用于交互事件
*/
- (UIView*)menu:(WMZDropDownMenu *)menu
userInteractionHeadViewInSection:(NSInteger)section;
/*
*自定义每行全局尾部视图 多用于交互事件
*/
- (UIView*)menu:(WMZDropDownMenu *)menu
userInteractionFootViewInSection:(NSInteger)section;
#pragma -mark 样式动画相关代理
/*
*返回WMZDropIndexPath每行 每列的UI样式 默认MenuUITableView
注:设置了dropIndexPath.section 设置了 MenuUITableView 那么row则全部
为MenuUITableView 保持统一风格
*/
- (MenuUIStyle)menu:(WMZDropDownMenu *)menu
uiStyleForRowIndexPath:(WMZDropIndexPath*)dropIndexPath;
/*
*返回section行标题数据视图出现的动画样式 默认
MenuShowAnimalBottom
注:最后一个默认是筛选 弹出动画为 MenuShowAnimalRight
*/
- (MenuShowAnimalStyle)menu:(WMZDropDownMenu *)menu
showAnimalStyleForRowInSection:(NSInteger)section;
/*
*返回section行标题数据视图消失的动画样式 默认 MenuHideAnimalTop
注:最后一个默认是筛选 消失动画为 MenuHideAnimalLeft
*/
- (MenuHideAnimalStyle)menu:(WMZDropDownMenu *)menu
hideAnimalStyleForRowInSection:(NSInteger)section;
/*
*返回WMZDropIndexPath每行 每列的编辑类型 单选|多选 默认单选
*/
- (MenuEditStyle)menu:(WMZDropDownMenu *)menu
editStyleForRowAtDropIndexPath:(WMZDropIndexPath*)dropIndexPath;
/*
*返回WMZDropIndexPath每行 每列 显示的个数
注:
样式MenuUITableView 默认4个
样式MenuUICollectionView 默认1个 传值无效
*/
- (NSInteger)menu:(WMZDropDownMenu *)menu
countForRowAtDropIndexPath:(WMZDropIndexPath*)dropIndexPath;
/*
*WMZDropIndexPath是否显示收缩功能 default >参数
wCollectionViewSectionShowExpandCount 显示
*/
- (BOOL)menu:(WMZDropDownMenu *)menu
showExpandAtDropIndexPath:(WMZDropIndexPath*)dropIndexPath;
/*
*WMZDropIndexPath上的内容点击 是否关闭视图 default YES
*/
- (BOOL)menu:(WMZDropDownMenu *)menu
closeWithTapAtDropIndexPath:(WMZDropIndexPath*)dropIndexPath;
/*
*是否关联 其他标题 即选中其他标题 此标题会不会取消选中状态 default
YES 取消,互不关联
*/
- (BOOL)menu:(WMZDropDownMenu *)menu
dropIndexPathConnectInSection:(NSInteger)section;
#pragma -mark 交互自定义代理
/*
*cell点击方法
*/
- (void)menu:(WMZDropDownMenu *)menu
didSelectRowAtDropIndexPath:(WMZDropIndexPath *)dropIndexPath
dataIndexPath:(NSIndexPath*)indexpath data:(WMZDropTree*)data;
/*
*标题点击方法
*/
- (void)menu:(WMZDropDownMenu *)menu didSelectTitleInSection:
(NSInteger)section btn:(WMZDropMenuBtn*)selectBtn;
/*
*确定方法 多个选择
selectNoramalData 转化后的的模型数据
selectData 字符串数据
*/
- (void)menu:(WMZDropDownMenu *)menu didConfirmAtSection:
(NSInteger)section selectNoramelData:(
NSMutableArray*)selectNoramalData selectStringData:
(NSMutableArray*)selectData;
/*
*自定义标题按钮视图 返回配置 参数说明
offset 按钮的间距
y 按钮的y坐标 自动会居中
*/
- (NSDictionary*)menu:(WMZDropDownMenu *)menu
customTitleInSection:
(NSInteger)section withTitleBtn:(WMZDropMenuBtn*)menuBtn;
/*
*自定义修改默认collectionView尾部视图
*/
- (void)menu:(WMZDropDownMenu *)menu
customDefauultCollectionFootView:(WMZDropConfirmView*)confirmView;
配置-链式语法调用(都是可选实现的)
MenuTitle相关
参数 | 类型 | 作用 (默认值) |
---|---|---|
wBorderShow | BOOL | 标题视图是否显示边框 default NO |
wFixBtnWidth | CGFLoat | 固定标题的宽度 default 80 |
wMenuTitleEqualCount | NSInteger | 标题等分个数 用来控制标题的宽度 default 4 |
wMenuLine | BOOL | 标题按钮添加下划线 dfault NO |
###弹出视图相关相关 | ||
参数 | 类型 | 作用 (默认值) |
------------------------ | ----------- | ----------------------------------------------------- |
wFixDataViewHeight | CGFLoat | 固定弹出显示数据层的高度 default 自动计算~>最大为屏幕高度的0.4倍 |
wMainRadius | CGFLoat | 弹窗视图的圆角 默认0 |
wMaxWidthScale | CGFLoat | 最大屏幕宽度系数 default 0.9 |
wMaxHeightScale | CGFLoat | 最大屏幕高度系数 default 0.4 |
wDefaultConfirmHeight | CGFLoat | 默认确定重置视图的高度 default 40 |
wPopViewWidth | CGFLoat | 弹出动画为pop时候 视图的宽度 default 屏幕宽度/3 |
wShadowColor | UIColor | 遮罩层颜色 default 333333 |
wShadowAlpha | CGFLoat | 遮罩层透明度 default 0.4 |
wShadowCanTap | BOOL | 遮罩层能否点击 default YES |
wShadowShow | BOOL | 遮罩层是否显示 default YES |
tableview相关
参数 | 类型 | 作用 (默认值) |
---|---|---|
wTableViewColor | NSArray | tableview的颜色 default @[FFFFFF,F6F7FA,EBECF0,FFFFFF] |
wTextAlignment | NSTextAlignment | cell文本居中样式 default left |
wCellSelectShowCheck | BOOL | tableViewCell 选中显示打钩图片 default YES |
collectionView相关
参数 | 类型 | 作用 (默认值) |
---|---|---|
wReginerCollectionCells | NSArray | 注册自定义的collectionViewCell 如果使用了自定义collectionView 必填否则会崩溃 |
wReginerCollectionHeadViews | NSArray | 注册自定义的collectionViewHeadView 如果使用了自定义collectionViewHeadView 必填 |
wReginerCollectionFootViews | NSArray | 注册自定义的collectionViewFoootView 如果使用了自定义collectionViewFoootView 必填 |
wCollectionViewCellSpace | CGFloat | colletionCell的间距 default 10 |
wCollectionViewCellBgColor | UIColor | colletionCell背景颜色 default 0x666666 |
wCollectionViewCellTitleColor | UIColor | colletionCell文字颜色 default 0xf2f2f2 |
wCollectionViewCellSelectBgColor | UIColor | colletionCell选中背景颜色 default 0xffeceb |
wCollectionViewCellSelectTitleColor | UIColor | colletionCell选中文字颜色 default red |
wCollectionViewCellBorderWith | CGFloat | colletionCell borderWidth default 0 |
wCollectionViewSectionShowExpandCount | NSInteger | colletionView section 超过多少个cell显示收缩按钮 default 6 |
wCollectionViewSectionRecycleCount | NSInteger | colletionView section 回收时候显示的cell数量 default 0 |
wCollectionViewDefaultFootViewMarginY | CGFloat | colletionViewFootView 距离底部的距离 默认0 当iphonex机型为 20 |
wCollectionViewDefaultFootViewPaddingY | CGFloat | colletionViewFootView 距离顶部的距离 默认0 |
内容有点多 不过要兼容所有的筛选 需要开放很多接口出来自定义,~ ~
其他具体看demo
如果实在觉得代理繁多,直接看我demo哪个app像你要实现的效果 复制代码 稍加修改哈哈。。。。
依赖
Aspects(注意检查下项目有没有已经用过这个AOP库哈,有就删掉一个就行了 一个.h一个.m文件哈)文件比较少 就懒得pod引用其他库了。~ ~直接拉在里面的
安装
CocoaPods
- 将 cocoapods 更新至最新版本.
- 在 Podfile 中添加
pod 'WMZDropDownMenu', '~> 1.2.0'
。 - 执行
pod install
或pod update
。 - 导入 #import "WMZDropDownMenu.h"。
手动安装
- 下载 WMZDropDownMenu 文件夹内的所有内容。
- 将 WMZDropDownMenu 内的源文件添加(拖放)到你的工程。
- 导入 #import "WMZDropDownMenu.h"
使用过程中如果有什么bug或者使用的问题欢迎给我提issue或者加我qq 我看到就会解决 简书地址
更新日记
- 20220928 v1.2.4 新增自定义弹出视图 需实现协议WMZDropShowViewProcotol
- 20220925 v1.2.3 修复#55
- 20220524 v1.2.2 修复#53
- 20220418 v1.2.1 适配ios15
- 20211015 v1.2.0 适配ios15
- 20210519 v1.1.6 修复#39
- 20210511 v1.1.5 修复快速点击的问题
- 20210422 v1.1.4 修复若干问题,去除警告
- 20201217 v1.1.3 新增自适应cell宽度样式 新增手动触发选中
- 20201023 v1.1.2 新增自定义更新标题
- 20200901 v1.1.1
- 20200801 v1.1.0 新增重置代理/修复bug
- 20200801 v1.0.9 新增自定义修改弹出视图frame的属性
- 20200716 v1.0.8 新增动态弹出视图位置的代理/新增弹出视图放置的视图的代理(collectionview/scrollView)
- 20200606 v1.0.7 新增一些代理方法
- 20200328 v1.0.6 修复bug
- 20200328 v1.0.5 新增查看更多功能 详情看京东demo
- 20200117 v1.0.4 过年前更一波
- 20191220 v1.0.3 修复退出后台数据源被自动清理掉的bug
- 20191213 v1.0.2 新增更新任意数据的方法
- 20191206 v1.0.0