更好用的仿微信、QQ弹框控件

先上效果图

Untitled.gif

前些时间在项目开发中用到这个带箭头的弹出框功能，为了开发进度，就随便在gitHub上找了个轮子使用了，也能实现我想要的功能，但是就是感觉不是想要的那种封装方式，使用起来比较麻烦，能不能像使用系统框架UIMenuController那样方便的使用这一控件呢？抱着这个想法，闲暇时间开始了HHPopController的探索

首先这个自定义控件使用起来非常简单方便，且可定制性很高，你只需要像下面这样使用

    HHPopItem *item1 = [HHPopItem itemWithImage:[UIImage imageNamed:@"ic_addvoucher_qrcode"] title:@"创建群聊"];
    HHPopItem *item2 = [HHPopItem itemWithImage:[UIImage imageNamed:@"ic_addvoucher_cinema"] title:@"加好友/群"];
    HHPopItem *item3 = [HHPopItem itemWithImage:[UIImage imageNamed:@"ic_addvoucher_input"] title:@"面对面快传"];
    [HHPopController applyPopStyle:^(HHPopStyle *style) {
        style.borderColor = [UIColor cyanColor];
        style.borderWidth = 1.0f;
        style.itemTextColor = [UIColor whiteColor];
        style.dimColor = [UIColor colorWithWhite:0.1 alpha:0.3];
        style.itemBgColor = [UIColor colorWithWhite:0.3 alpha:1.0];
        
//        HHPopSupplementaryStyle *header = [HHPopSupplementaryStyle defaultStyle];
//        header.bgColor = style.itemBgColor;
//        header.title = @"header";
//        header.titleColor = [UIColor whiteColor];
//        style.header = header;
//        
//        HHPopSupplementaryStyle *footer = [HHPopSupplementaryStyle defaultStyle];
//        footer.bgColor = style.itemBgColor;
//        footer.title = @"footer";
//        footer.titleColor = [UIColor whiteColor];
//        style.footer = footer;
    }];
    [HHPopController popSourceView:btn popItems:@[item1, item2, item3] selectionHandler:^(NSInteger idx, HHPopItem *item) {
        NSLog(@"%@", item.title);
    }];

先来看下类HHPopItem的定义

/// 弹出视图数据模型
@interface HHPopItem : NSObject
+ (instancetype)itemWithTitle:(NSString *)title;
+ (instancetype)itemWithImage:(UIImage *)image title:(NSString *)title;
@property (nonatomic, strong)UIImage *image;
@property (nonatomic, strong)NSString *title;
- (void)setHandler:(void (^)(NSInteger idx, HHPopItem *item))handler;
@end

这里你可以创建只含有标题或者含有图片和标题两种样式，并且可以通过block配置点击的回调

方法+ (void)applyPopStyle:(void (^)(HHPopStyle *style))maker;通过block传进一个模型来配置该控件所有的样式，可定制的属性如下

/// 弹出视图样式模型
@interface HHPopStyle : NSObject

/// 弹出视图的宽度
@property (nonatomic, assign)CGFloat popWidth;

/// 边框颜色
@property (nonatomic, strong)UIColor *borderColor;
/// 边框宽度
@property (nonatomic, assign)CGFloat borderWidth;


/// 行高
@property (nonatomic, assign)CGFloat rowHeight;
/// 圆角尺寸
@property (nonatomic, assign)CGFloat cornerRadius;
/// 蒙版颜色
@property (nonatomic, strong)UIColor *dimColor;
/// 箭头方向
@property (nonatomic, assign)HHArrowStyle arrowStyle;
/// 箭头离矩形边框的距离大小
@property (nonatomic, assign)CGFloat arrowDistanceFromTargetRectBorder;
/// 箭头尺寸, 对应三角形的宽高 default {15, 8}
@property (nonatomic, assign)CGSize arrowSize;
/// 弹框显现的区域限制
@property (nonatomic, assign)UIEdgeInsets popAreaEdgeLimits;
/// 出现的动画时间 default 0.25
@property (nonatomic, assign)CGFloat animationIn;
/// 小时的动画时间 default 0.25
@property (nonatomic, assign)CGFloat animationOut;
/// 是否能滚动 当弹框范围能够容纳的下为NO, 否则为YES
@property (nonatomic, assign)BOOL bounces;

/// 分割线颜色
@property (nonatomic, strong)UIColor *separatorColor;
/// 分割线内边距
@property (nonatomic, assign)UIEdgeInsets separatorInset;

/// 选项的背景颜色
@property (nonatomic, strong)UIColor *itemBgColor;
/// 选项的图片内容模式
@property (nonatomic, assign)UIViewContentMode itemImageContentMode;
/// 选项文字对齐方式
@property (nonatomic, assign)NSTextAlignment itemTextAligment;
/// 选项文字字体
@property (nonatomic, strong)UIFont *itemTextFont;
/// 选项文字颜色
@property (nonatomic, strong)UIColor *itemTextColor;

/// 头部样式
@property (nonatomic, strong)HHPopSupplementaryStyle *header;

/// 尾部样式
@property (nonatomic, strong)HHPopSupplementaryStyle *footer;

+ (instancetype)defaultStyle;

@end

看注释应该很明显了，其中这里还可以通过HHPopSupplementaryStyle模型来配置头部数据和尾部数据，其实就是UITableView的header和footer，HHPopSupplementaryStyle的定义如下

/// 弹出视图的追加视图模型 (header and footer)
@interface HHPopSupplementaryStyle : NSObject

/// 标题
@property (nonatomic, copy)NSString *title;
/// 标题高度
@property (nonatomic, assign)CGFloat height;
/// 标题文字对齐方式
@property (nonatomic, assign)NSTextAlignment titleAligment;
/// 标题文字颜色
@property (nonatomic, strong)UIColor *titleColor;
/// 标题背景颜色
@property (nonatomic, assign)UIColor *bgColor;
/// 标题文字字体
@property (nonatomic, strong)UIFont *titleFont;
/// 自定义头部视图
@property (nonatomic, strong)UIView *customView;

+ (instancetype)defaultStyle;

@end

HHArrowStyle是个枚举类型

/// 箭头方式
typedef NS_ENUM(NSInteger, HHArrowStyle) {
    HHArrowStyleVerticalDefault = 0, ///< up or down based on source view location in window
    HHArrowStyleHorizontalDefault, ///< left or right based on source view location in window
    HHArrowStyleUp,///< up force
    HHArrowStyleDown,/// < down force
    HHArrowStyleLeft,///< left force
    HHArrowStyleRight///< right force
};

如果不需要显示箭头可以设置arrowSize为CGSizeZero。
最后我们在看下HHPopController的定义

/// 弹出视图控制器
@interface HHPopController : NSObject

+ (void)applyReturnPopStyle:(HHPopStyle *(^)(HHPopStyle *style))maker;

+ (void)applyPopStyle:(void (^)(HHPopStyle *style))maker;

+ (void)popSourceView:(UIView *)view popItems:(NSArray *)items selectionHandler:(void (^)(NSInteger idx, HHPopItem *item))handler;

+ (void)popTargetRect:(CGRect)rect soureceView:(UIView *)view popItems:(NSArray *)items selectionHandler:(void (^)(NSInteger idx, HHPopItem *item))handler;

+ (BOOL)isPopVisible;

+ (void)dismiss;

@end

配置回调有两种方式，可以通过模型，也可以通过handler参数，使用起来是不是简单明了？既然封装就要封装的彻底点，外界怎么用着舒服就怎么来，嘿嘿，通过模型来配置一些属性，避开了要写一堆的代理方法或者block，但还是有一些缺点的，比如动画支持不是很丰富等

另外还可以通过以下通知名监听对应的通知

FOUNDATION_EXTERN NSString *const HHPopControllerWillPopNotification;
FOUNDATION_EXTERN NSString *const HHPopControllerDidPopNotification;
FOUNDATION_EXTERN NSString *const HHPopControllerWillHidenNotification;
FOUNDATION_EXTERN NSString *const HHPopControllerDidHidenNotification;

可以通过cocopods安装使用

pod 'HHPopController'

好了，功能就这么多，有兴趣的可以看下源码，也很好理解，有什么问题或建议欢迎留言，如果能在开发中帮助到你也算没有白忙活，谢谢大家，喜欢的麻烦给个赞呗！
gitHub传送门https://github.com/theSkyOfJune/HHPopController