iOS Team / CNliveBBASMModule · Files

BBACommonPopupMenu.h 9.99 KB
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 
//
//  BBACommonPopupMenu.h
//  BBAUIKit
//
//  Created by Ning,Liujie on 2020/7/15.
//  Copyright © 2020 Baidu. All rights reserved.
//

#import <Foundation/Foundation.h>
#import "BBACommonPopupMenuItem.h"
#import "BBACommonPopupMenuDefine.h"

NS_ASSUME_NONNULL_BEGIN

typedef void(^BBACommonPopupMenuDismissBlock)(void);

@interface BBACommonPopupMenu : NSObject

/// popupmenu消失回调 （点击menu内的item后消失同样会执行次回调）
@property (nonatomic, copy) BBACommonPopupMenuDismissBlock dismissBlock;

/**
* 展示 popupMenu
*
* 弹框展示规则：弹框默认向下展示，如果下面展示不下，会向上展示，如果展示不下，会比较向上和向下的距离，向距离大的方向展示

* @param itemArray 列表的数据
* @param targetView 传入点击View,根据传入的View，进行弹框的布局
* @param itemClickBlock item点击的回调事件
*/
+ (instancetype)showWithItem:(NSArray <BBACommonPopupMenuItem *> *)itemArray
                  targetView:(UIView *)targetView
                   itemClick:(void(^)(NSInteger index))itemClickBlock;

/**
 * 展示 popupMenu
 *
 * 弹框展示规则：弹框默认向下展示，如果下面展示不下，会向上展示，如果展示不下，会比较向上和向下的距离，向距离大的方向展示
 * 如果配置箭头方向，则优先向配置的箭头方向展示，如果该方向展示不下，则尝试向其它方向展示，同上面规则
 *
 * @param itemArray 列表的数据
 * @param targetView 需要显示在传入的View 的上方或者下方，取传入view 的中点的上边缘或者下边缘确定箭头的显示位置，弹出弹框，如果没有箭头，则基于中点位置，进行布局
 * @param showArrow 是否需要箭头
 * @param itemClickBlock item点击的回调事件
 */
+ (instancetype)showWithItem:(NSArray <BBACommonPopupMenuItem *> *)itemArray
                  targetView:(UIView *)targetView
                   showArrow:(BOOL)showArrow
                   itemClick:(void(^)(NSInteger index))itemClickBlock;
/**
 * 展示 popupMenu
 *
 * 弹框展示规则：弹框默认向下展示，如果下面展示不下，会向上展示，如果展示不下，会比较向上和向下的距离，向距离大的方向展示
 * 如果配置箭头方向，则优先向配置的箭头方向展示，如果该方向展示不下，则尝试向其它方向展示，同上面规则
 *
 * @param itemArray 列表的数据
 * @param targetView 传入点击View,根据传入的View，进行弹框的布局
 * @param showArrow 是否需要箭头
 * @param showMask 是否需要蒙层，不透明度50%
 * @param itemClickBlock item点击的回调事件
 */
+ (instancetype)showWithItem:(NSArray <BBACommonPopupMenuItem *> *)itemArray
                  targetView:(UIView *)targetView
                   showArrow:(BOOL)showArrow
                    showMask:(BOOL)showMask
                   itemClick:(void(^)(NSInteger index))itemClickBlock;

/**
 * 展示 popupMenu
 *
 * 弹框展示规则：弹框默认向下展示，如果下面展示不下，会向上展示，如果展示不下，会比较向上和向下的距离，向距离大的方向展示
 * 如果配置箭头方向，则优先向配置的箭头方向展示，如果该方向展示不下，则尝试向其它方向展示，同上面规则
 *
 * @param itemArray 列表的数据
 * @param targetView 传入点击View,根据传入的View，进行弹框的布局
 * @param showArrow 是否需要箭头
 * @param arrowDirection 箭头方向，传入对应的的方向，内部会优先向传入的方向弹出，如果弹出的方向，展示不下，会进行展示方向判断，展示规则同弹框展示规则
 * @param showMask 是否需要蒙层，不透明度50%
 * @param itemClickBlock item点击的回调事件
 */
+ (instancetype)showWithItem:(NSArray <BBACommonPopupMenuItem *> *)itemArray
                  targetView:(UIView *)targetView
                   showArrow:(BOOL)showArrow
              arrowDirection:(BBACommonPopupMenuArrowDirection)arrowDirection
                    showMask:(BOOL)showMask
                   itemClick:(void(^)(NSInteger index))itemClickBlock;

/**
 * 展示 popupMenu
 *
 * 弹框展示规则：弹框默认向下展示，如果下面展示不下，会向上展示，如果展示不下，会比较向上和向下的距离，向距离大的方向展示
 * 如果配置箭头方向，则优先向配置的箭头方向展示，如果该方向展示不下，则尝试向其它方向展示，同上面规则
 *
 * @param itemArray 列表的数据
 * @param targetView 传入点击View,根据传入的View，进行弹框的布局
 * @param showArrow 是否需要箭头
 * @param arrowDirection 箭头方向，传入对应的的方向，内部会优先向传入的方向弹出，如果弹出的方向，展示不下，会进行展示方向判断，展示规则同弹框展示规则
 * @param showMask 是否需要蒙层，不透明度50%
 * @param positionOffset 位置偏移值
 * @param offsetBaseline 默认不进行处理，选择不同的基线，以选择的基线，正数向右偏移，负数向左偏移 例如：以左边基线为例，设置偏移值，就是 该弹框的x 值 最小边距 + 偏移值
 * @param itemClickBlock item点击的回调事件
 */
+ (instancetype)showWithItem:(NSArray <BBACommonPopupMenuItem *> *)itemArray
                  targetView:(UIView *)targetView
                   showArrow:(BOOL)showArrow
              arrowDirection:(BBACommonPopupMenuArrowDirection)arrowDirection
                    showMask:(BOOL)showMask
              positionOffset:(CGFloat)positionOffset
              offsetBaseline:(BBACommonPopupMenuPositionOffsetBaseline)offsetBaseline
                   itemClick:(void(^)(NSInteger index))itemClickBlock;

/**
* 展示 popupMenu
*
* 弹框展示规则：弹框默认向下展示，如果下面展示不下，会向上展示，如果展示不下，会比较向上和向下的距离，向距离大的方向展示

* @param customView 自定义的视图
* @param targetView 传入点击View,根据传入的View，进行弹框的布局
 */
+ (instancetype)showWithCustomView:(UIView *)customView
                        targetView:(UIView *)targetView;

/**
* 展示popupMenu
*
* 弹框展示规则：弹框默认向下展示，如果下面展示不下，会向上展示，如果展示不下，会比较向上和向下的距离，向距离大的方向展示
 如果配置箭头方向，则优先向配置的箭头方向展示，如果该方向展示不下，则尝试向其它方向展示，同上面规则
*
* @param customView 自定义的视图
* @param targetView 传入点击View,根据传入的View，进行弹框的布局
* @param showMask 是否需要蒙层，不透明度50%
* @param showArrow 是否需要箭头
*/
+ (instancetype)showWithCustomView:(UIView *)customView
                        targetView:(UIView *)targetView
                          showMask:(BOOL)showMask
                         showArrow:(BOOL)showArrow;

/**
* 展示popupMenu
*
* 弹框展示规则：弹框默认向下展示，如果下面展示不下，会向上展示，如果展示不下，会比较向上和向下的距离，向距离大的方向展示
 如果配置箭头方向，则优先向配置的箭头方向展示，如果该方向展示不下，则尝试向其它方向展示，同上面规则
*
* @param customView 自定义的视图
* @param targetView 传入点击View,根据传入的View，进行弹框的布局
* @param showMask 是否需要蒙层，不透明度50%
* @param showArrow 是否需要箭头
* @param arrowDirection 箭头方向，传入对应的的方向，内部会优先向传入的方向弹出，如果弹出的方向，展示不下，会进行展示方向判断，展示规则同弹框展示规则
*/
+ (instancetype)showWithCustomView:(UIView *)customView
                        targetView:(UIView *)targetView
                          showMask:(BOOL)showMask
                         showArrow:(BOOL)showArrow
                    arrowDirection:(BBACommonPopupMenuArrowDirection)arrowDirection;

/**
* 展示popupMenu
*
* 弹框展示规则：弹框默认向下展示，如果下面展示不下，会向上展示，如果展示不下，会比较向上和向下的距离，向距离大的方向展示
 如果配置箭头方向，则优先向配置的箭头方向展示，如果该方向展示不下，则尝试向其它方向展示，同上面规则
*
* @param customView 自定义的视图
* @param targetView 传入点击View,根据传入的View，进行弹框的布局
* @param showMask 是否需要蒙层，不透明度50%
* @param showArrow 是否需要箭头
* @param arrowDirection 箭头方向，传入对应的的方向，内部会优先向传入的方向弹出，如果弹出的方向，展示不下，会进行展示方向判断，展示规则同弹框展示规则
* @param positionOffset 位置偏移值
* @param offsetBaseline 默认不进行处理，选择不同的基线，以选择的基线，正数向右偏移，负数向左偏移 例如：以左边基线为例，设置偏移值，就是 该弹框的x 值 最小边距 + 偏移值
 
*/
+ (instancetype)showWithCustomView:(UIView *)customView
                        targetView:(UIView *)targetView
                          showMask:(BOOL)showMask
                         showArrow:(BOOL)showArrow
                    arrowDirection:(BBACommonPopupMenuArrowDirection)arrowDirection
                    positionOffset:(CGFloat)positionOffset
                    offsetBaseline:(BBACommonPopupMenuPositionOffsetBaseline)offsetBaseline;

/**
* 更新展示的popupMenu的列表
*
* @param itemArray 列表的数据
*/
- (void)updateWithItems:(NSArray <BBACommonPopupMenuItem *> *)itemArray;

/**
* 更新展示的popupMenu的自定义View
*
* @param customView 自定义的视图
*/
- (void)updateWithCustomView:(UIView *)customView;

/**
* 外部更新了已加入列表item数据或者自定义的视图，需要刷新界面，调用该方法进行界面刷新
*
*/
- (void)reloadData;

/**
* 隐藏popupMenu
*
*/
- (void)hideWithAnimation:(BOOL)isAnimation;

/**
* 是否有弹框展示
*
*/
+ (BOOL)isShow;

@end

NS_ASSUME_NONNULL_END