# WMZDropDownMenu **Repository Path**: admin_957804349/WMZDropDownMenu ## Basic Information - **Project Name**: WMZDropDownMenu - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2021-03-15 - **Last Updated**: 2023-11-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # WMZDropDownMenu [![Platform](https://img.shields.io/badge/platform-iOS-red.svg)](https://developer.apple.com/iphone/index.action) [![CocoaPods Compatible](https://img.shields.io/cocoapods/v/WMZDropDownMenu.svg)](https://img.shields.io/cocoapods/v/WMZDropDownMenu.svg) [![License](https://img.shields.io/badge/license-MIT-blue.svg)](http://mit-license.org) 实现功能 ============== - 组合自定义功能 - 支持自定义多选|单选|复选 - 支持自定义弹出的动画 (目前已实现向下,向左全屏,向右全屏,拼多多对话框弹出,boss直聘全屏弹出) - 支持自定义tableView/collectionView头尾视图 - 支持自定义全局头尾视图 - 支持自定义collectionCell/tableViewCell视图 - 支持自定义标题 - 支持自定义点击回收视图 - 支持自定义回收列表 - 支持任意级的联动(由于数据比较庞杂,暂时自动适配不了无限级的联动,所以需要你调用一个方法更新数据传给我,详情看Demo) - 支持嵌套使用,即两个筛选菜单可以连着使用 - 支持放在放在任意视图上 - 支持控制器消失自动关闭视图，无须再控制器消失方法里手动关闭 - 链式实现所有配置的自定义修改 (总之，你想要的基本都有,不想要的也有) ### 下一步 优化使用，增加自定义View的支持 --- 已完成 #目前已经用这控件实现的效果图 ⚠️⚠️⚠️⚠️无须改变源码 只需要调用我的代理组合功能即可⚠️⚠️⚠️⚠️ ### 注意：如果弹出的视图的y值不准确 你可以手动设置menu的menuOrignY属性 ### 也可以设置wPopOraignY属性 ### 也可以在新增的代理 - (CGFloat)popFrameY; 设置 （1.0.8后才有） | app筛选菜单 | 图片 | |-----------------------|-----------------------------------------------------| | 仿闲鱼筛选菜单 | ![xianyu.gif](https://upload-images.jianshu.io/upload_images/9163368-3df9ac4b45352b4b.gif?imageMogr2/auto-orient/strip)| | 仿美团筛选菜单 | ![meituan.gif](https://upload-images.jianshu.io/upload_images/9163368-fc0d363e925e9b84.gif?imageMogr2/auto-orient/strip)| | 饿了么筛选菜单 |![eleme.gif](https://upload-images.jianshu.io/upload_images/9163368-ab4ba51a21353c50.gif?imageMogr2/auto-orient/strip)| | 京东筛选菜单 | ![Jingdong.gif](https://upload-images.jianshu.io/upload_images/9163368-52beb31fc6f2f0bf.gif?imageMogr2/auto-orient/strip)| |拼多多筛选菜单 |![pinduoduo.gif](https://upload-images.jianshu.io/upload_images/9163368-00eba09306587483.gif?imageMogr2/auto-orient/strip) | | 简书筛选菜单 |![jianshu.gif](https://upload-images.jianshu.io/upload_images/9163368-086566f77b9bdab7.gif?imageMogr2/auto-orient/strip) | | 赶集网筛选菜单 |![ganjiwang.gif](https://upload-images.jianshu.io/upload_images/9163368-8de1befc145ee6f7.gif?imageMogr2/auto-orient/strip) | |美团外卖筛选菜单 | ![meituanwaimai.gif](https://upload-images.jianshu.io/upload_images/9163368-fa0d57fa3b89bf9e.gif?imageMogr2/auto-orient/strip)| |Boss直聘筛选菜单 |![Boss.gif](https://upload-images.jianshu.io/upload_images/9163368-289df75bc0c8e07b.gif?imageMogr2/auto-orient/strip) | |唯品会筛选菜单 | ![weipinhui.gif](https://upload-images.jianshu.io/upload_images/9163368-bfab522a0eb631a3.gif?imageMogr2/auto-orient/strip)| |一淘筛选菜单 | ![yitao.gif](https://upload-images.jianshu.io/upload_images/9163368-56393dc9b1003fdf.gif?imageMogr2/auto-orient/strip)| #我手机只有这么一些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 1. 将 cocoapods 更新至最新版本. 2. 在 Podfile 中添加 `pod 'WMZDropDownMenu', '~> 1.2.0'`。 3. 执行 `pod install` 或 `pod update`。 4. 导入 #import "WMZDropDownMenu.h"。 ### 手动安装 1. 下载 WMZDropDownMenu 文件夹内的所有内容。 2. 将 WMZDropDownMenu 内的源文件添加(拖放)到你的工程。 3. 导入 #import "WMZDropDownMenu.h" 使用过程中如果有什么bug或者使用的问题欢迎给我提issue或者加我qq 我看到就会解决 [简书地址](https://www.jianshu.com/p/366d5bb08766) ### 更新日记 - 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