Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/wwmz/WMZDropDownMenu

🌹一个能几乎实现所有App各种类型筛选菜单的控件,可悬浮,目前已实现闲鱼/美团/Boss直聘/京东/饿了么/淘宝/拼多多/赶集网/美图外卖等等的筛选菜单,可以自由调用代理实现自己想组装的筛选功能和UI,且控件的生命周期自动管理,悬浮自动管理🌹(A control that can implement almost all types of filtering menus of all apps)
https://github.com/wwmz/WMZDropDownMenu
allmenu custom custommenu dropmenu menu
Last synced: 3 months ago
JSON representation
Host: GitHub
URL: https://github.com/wwmz/WMZDropDownMenu
Owner: wwmz
License: mit
Created: 2019-11-30T15:49:26.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2022-09-28T08:59:12.000Z (about 2 years ago)
Last Synced: 2024-07-10T12:15:27.754Z (4 months ago)
Topics: allmenu, custom, custommenu, dropmenu, menu
Language: Objective-C
Homepage:
Size: 6.02 MB
Stars: 716
Watchers: 6
Forks: 98
Open Issues: 9
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project

Awesome-iOS - WMZDropDownMenu - 一个能几乎实现所有App各种类型筛选菜单的控件 (UI Components)
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