iOS原生弹框框架-TRCustomAlert

2,053 阅读4分钟

编写alert的初衷是由于工作的需要和使用系统的alert弹框,编写起来太过于麻烦,需要写好多行的代码,本打算想编辑保存成代码块,通过敲关键字生成,但是最终一狠心,自己便写了一个原生alert弹框,同时基于该原生框架的RN库也发布了(文章底下的链接),具体api和效果如下:

项目集成 pod 'TRCustomAlert'

导入头文件 #import "TRCustomAlert.h"

前言:该框架api调用均为类方法,在设置样式时,需创建弹框实体在设置样式

项目API组成

api总共分为四个部分
  • 简单提示框类型
  • 带按钮强提示框类型
  • 加载等待(loading)提示框类型
  • 弹框属性设置

1、简单提示框样式

简单提示框,默认消失时间为2秒

方法名 说明
+(void)showSuccessWithMessage:(NSString *)message 显示简单成功提示框
+(void)showErrorWithMessage:(NSString *)message 显示简单错误提示框
+(void)showWarningWithMessage:(NSString *)message 显示简单警告提示框
+(void)showShadeSuccessWithMessage:(NSString *)message 显示有遮罩简单成功提示框
+(void)showShadeErrorWithMessage:(NSString *)message 显示有遮罩错误提示框
+(void)showShadeWarningWithMessage:(NSString *)message 显示有遮罩警告提示框
+(void)showMessage:(NSString *)message image:(UIImage *)image 显示自定义顶部图标简单提示框,(参数传nil可以,不显示图片)
+(void)showShadeWithMessage:(NSString *)message image:(UIImage *)image 显示有遮罩自定义顶部图标简单提示框,(参数传nil可以,不显示图片)
+(void)showBottomMessage:(NSString *)message 显示在底部的纯文字提示框

2、带按钮的强提示框

参数中CustomAlertStyle标识该弹框的类型分为以下三个类型,分别对应三种默认图片

    CustomAlertStyleSuccess,//默认成功图片
    CustomAlertStyleError,//默认错误图片
    CustomAlertStyleWarning,//默认警告图片
    CustomAlertStyleNone  //没有图片
方法名 说明
+(void)showAlertFullWithStyle:(CustomAlertStyle)style title:(NSString *)title content:(NSString *)content complete:(complete)completeBlock 自带确定和取消,默认图片样式
+(void)showAlertFullWithImage:(UIImage *)image title:(NSString *)title content:(NSString *)content complete:(complete)completeBlock 自带确定和取消,自定义图片样式
+(void)showAlertFinishWithStyle:(CustomAlertStyle)style title:(NSString *)title content:(NSString *)content complete:(complete)completeBlock 只有一个确定按钮样式,默认图片
+(void)showAlertFinishWithImage:(UIImage *)image title:(NSString *)title content:(NSString *)content complete:(complete)completeBlock 只有一个确定按钮样式,自定义图片
+(void)showAlertWithButtonTitleArray:(NSArray<NSString *> *)titleArray style:(CustomAlertStyle)style title:(NSString *)title content:(NSString *)content complete:(complete)completeBlock 自定义按钮(titleArray参数传递按钮显示字符即可),默认图片样式
+(void)showAlertWithButtonTitleArray:(NSArray<NSString *> *)titleArray image:(UIImage *)image title:(NSString *)title content:(NSString *)content complete:(complete)completeBlock 自定义按钮(titleArray参数传递按钮显示字符即可),自定义图片样式

3、加载(loading)等待样式

方法名 说明
+(void)showLoading 不带文字的加载等待
+(void)showShadeLoading 不带文字的有遮罩的加载等待
+(void)showLoadingWithMessage:(NSString *)message 带文字的加载等待
+(void)showShadeLoadingWithMessage:(NSString *)message 带文字和遮罩的加载等待

4、隐藏以上窗体方法

+(void)dissmis;//隐藏

5、进度条和自定义视图

进度条进度设置通过 @property(nonatomic,assign)CGFloat progress;//进度 0~1 属性控制

方法名 说明
+(instancetype)showProgressWithTitle:(NSString *)title content:(NSString *)content 根据标题和内容创建进度条
+(instancetype)showProgressWithTitle:(NSString *)title content:(NSString *)content complete:(complete)completeBlock 根据标题和内容创建带按钮的进度条
+(instancetype)showProgressWithTitle:(NSString *)title content:(NSString *)content buttonTitle:(NSString *)buttonTitle complete:(complete)completeBlock 根据用户自定义按钮创建进度条
+(instancetype)showCustomeViewWithButtonTitleArray:(NSArray<NSString *> *)buttonTitleArray innerView:(UIView *)innerView title:(NSString *)title content:(NSString *)content complete:(customComplete)completeBlock 根据用户自定义按钮和中间视图,创建弹框

6、样式设置

方法名 说明
+(void)setBackgroundColor:(UIColor *)color 设置背景色
+(void)setFontColor:(UIColor *)color; 设置文字字体颜色(简单框文字,按钮框的内容,loading框文字)
+(void)setFont:(UIFont *)font 设置文字字体字体(简单框文字,按钮框的内容,loading框文字)
+(void)setTitleColor:(UIColor *)color 设置按钮框标题颜色
+(void)setTitleFont:(UIFont *)font 设置按钮框标题字体
+(void)setButtonColor:(UIColor *)color 设置按钮弹框底部所有按钮颜色
+(void)setButtonFont:(UIFont *)font 设置按钮弹框底部所有按钮字体
+(void)setButtonFont:(UIFont *)font color:(UIColor *)color 设置按钮弹框底部所有按钮字体和颜色
+(void)setButtonColor:(UIColor *)color index:(NSInteger)index 设置按钮弹框底部按钮index位置的颜色(这个位置和titleArray传递的顺序一致)
+(void)setButtonFont:(UIFont *)font index:(NSInteger)index 设置按钮弹框底部按钮index位置的字体(这个位置和titleArray传递的顺序一致)
+(void)setButtonFont:(UIFont *)font color:(UIColor *)color index:(NSInteger)index 设置按钮弹框底部按钮index位置的字体和颜色(这个位置和titleArray传递的顺序一致)
+(void)setAlertCornerRadius:(CGFloat)value 设置弹框的圆角

7、部分效果图

喜欢的请不要吝啬你的star,使用中有什么问题或者有好的建议都可以提issues

TRCustomeAlert gitHub

TRCustomeAlert-RN gitHub