XUAlertView 0.1.0

XUAlertView 0.1.0

×

由xupeng维护。

XUAlertView 0.1.0

  • 由
  • xupeng

XUAlertView

XUAlertView是蜻蜓FM iOS客户端对蜻蜓FM风格AlertView的封装。

安装

// tag替换为最新的
pod 'XUAlertView', :git => "[email protected]:CocoaPods/XUAlertView.git", :tag => '0.1.0'

使用

基础使用

1.创建XUAlertAction的实例

XUAlertAction *action = [XUAlertAction actionFullWithTitle:@"确 定" style:XUAlertActionStyleRecommend];

2.创建XUAlertView的实例

XUAlertView *alert = [XUAlertView alertWithIconImage:nil
headerImage:[UIImage imageNamed:@"notificationAlertBackgorund"]
title:@"流量提醒"
message:@"当前无WiFi，是否允许流量收听？"
customView:nil];

3.alert添加action

[alert addAction:action];

4.alert展示

[alert display];

效果如下

部分快捷方法

/**
底部单按钮 右上角关闭按钮 AlertView

@param title 标题
@param message 内容
@param isShowClose  是否显示关闭按钮
@param closeClick   关闭按钮点击事件
@param confirmTitle 确认按钮标题
@param confirmStyle 确认按钮风格
@param confirmClick 确认按钮点击事件
*/
+ (void)showAlertWithTitle:(NSString * _Nullable)title message:(NSString * _Nullable)message showClose:(BOOL)isShowClose closeClick:(nullable void(^)(void))closeClick confirmTitle:(NSString * _Nullable)confirmTitle confirmStyle:(XUAlertActionStyle)confirmStyle confirmClick:(nullable void(^)(void))confirmClick;

/**
底部单按钮 AlertView

@param title 标题
@param message 内容
@param confirmTitle 确认按钮标题
@param confirmStyle 确认按钮风格
@param confirmClick 确认按钮点击事件
*/
+ (void)showAlertWithTitle:(NSString * _Nullable)title message:(NSString * _Nullable)message confirmTitle:(NSString * _Nullable)confirmTitle confirmStyle:(XUAlertActionStyle)confirmStyle confirmClick:(nullable void(^)(void))confirmClick;

/**
底部双按钮 AlertView

@param title 标题
@param message 内容
@param cancelTitle  取消按钮标题
@param cancelClick  取消按钮点击事件
@param confirmTitle 确认按钮标题
@param confirmClick 确认按钮点击事件
*/
+ (void)showAlertWithTitle:(NSString * _Nullable)title message:(NSString * _Nullable)message cancelTitle:(NSString * _Nullable)cancelTitle cancelClick:(nullable void(^)(void))cancelClick confirmTitle:(NSString * _Nullable)confirmTitle confirmClick:(nullable void(^)(void))confirmClick;

内容介绍

XUAlertAction负责AlertView中的UIButton样式

枚举XUAlertActionStyle表示UIButton的样式

typedef NS_ENUM(NSInteger, XUAlertActionStyle) {
XUAlertActionStyleRecommend,             // 颜色渐变, 白字
XUAlertActionStyleNotRecommend,          // 白色背景, 红色边框, 红字
XUAlertActionStyleCustom,                // 自定义 Default font: 16.0 height: 20.0 backgroundColor: white
};

枚举XUAlertActionLayout表示UIButton的布局

typedef NS_ENUM(NSInteger, XUAlertActionLayout) {
XUAlertActionLayoutFull,                 // 占据全部可用空间
XUAlertActionLayoutHalfWidth,            // 宽度 0.5 高度 1.0
XUAlertActionLayoutCustomHeight,         // 宽度 1.0 高度 Custom
};

以下方法用于创建XUAlertAction实例

/**
XUAlertActionLayoutFull && click自己需求的点击事件
*/
+ (instancetype)actionFullWithTitle:(NSString *)title style:(XUAlertActionStyle)style;
+ (instancetype)actionFullWithTitle:(NSString *)title style:(XUAlertActionStyle)style onClick:(void(^)(void))onClick;

/**
XUAlertActionLayoutHalfWidth && click自己需求的点击事件
*/
+ (instancetype)actionHalfWidthWithTitle:(NSString *)title style:(XUAlertActionStyle)style;
+ (instancetype)actionHalfWidthWithTitle:(NSString *)title style:(XUAlertActionStyle)style onClick:(void(^)(void))onClick;

/**
自定义按钮样式: XUAlertActionStyleCustom && XUAlertActionLayoutCustomHeight

@note: Default font: 16.0 height: 20.0 backgroundColor: white
@note: config中直接设置button的frame font等
*/
+ (instancetype)actionCustomWithTitle:(NSString *)title config:(void(^)(UIButton *))config;

XUAlertView负责AlertView中的View

/**
创建一个弹窗实例

@param iconImage icon 图片
@param headerImage header 图片
@param title 标题
@param message 文字描述
@param customView 自定义View 自带距离顶部: 16.0 底部按钮: 20.0
@return 弹窗实例
*/
+ (instancetype)alertWithIconImage:(UIImage *)iconImage
headerImage:(UIImage *)headerImage
title:(NSString *)title
message:(NSString *)message
customView:(UIView *)customView;

/**
添加动作，按钮会按照添加的顺序由高到低排列
*/
- (void)addAction:(XUAlertAction *)action;

/**
添加右上角的圆形关闭按钮，并添加动作
*/
- (void)addCloseButtonWithAction:(void(^)(void))action;

/**
对标题和message进行额外的配置，比如修改字体，对齐方式

@note: 修改frame无效
*/
- (void)addExtraConfig:(void(^)(UILabel * titleLabel, UILabel * messageLabel))config;

/**
完全自定义 View
*/
+ (instancetype)alertWithCompleteCustomView:(UIView *)view;

/**
展示
*/
- (void)display;
- (void)display:(void(^)(void))completion;

/**
隐藏
*/
- (void)hide;
- (void)hide:(void(^)(void))completion;