TRCustomAlert 0.2.6

TRCustomAlert 0.2.6

Maintained by troila.



TRCustomAlert V0.2.5

CocoaPods Compatible Pod Platform Pod License cocoapods support languages

项目集成 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 显示在底部的纯文字提示框
+(void)showFitBottomMessage:(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 设置弹框的圆角
+(void)setConfirmImageColor:(UIColor *)color; 设置确认框图片颜色
+(void)setAlertBtnClickBackgroundColorWithColor:(UIColor *)color index:(NSInteger)index 设置按钮对话框按钮点击高亮背景色
+(void)setButtonBackgroundColor:(UIColor *)color index:(NSInteger)index; 设置按钮对话框按钮背景色
+(void)setLoadingWithStyle:(TRLoadingStyle)style; 设置loading活动指示器样式

7、部分效果图,完整演示,请运行Demo

8、版本变更记录

  • 2019.08-08 -- V0.2.5 --修复首次加载时loading,gif图载入过慢的问题
  • 2019.06-11 -- V0.2.4 --修复弹框控件样式bug
  • 2019.06-10 -- V0.2.3 --修复在特定状况下,横竖屏获取失败问题
  • 2019.06-04 -- V0.2.2 --修复在iOS 11系统下底部弹框位置不正确bug
  • 2019.05-25 -- V0.2.1 --修复底部自适应弹框宽高使用iOS系统方法计算时有误差,改为Masonry方式设置最大宽度
  • 2019.05-24 -- V0.2.0 --更改布局使用Masonry三方,摒弃使用的Frame方式,增加横竖屏方向的支持,增加设置样式的接口