CocoaPods trunk is moving to be read-only. Read more on the blog, there are 18 months to go.

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方式,增加横竖屏方向的支持,增加设置样式的接口