224 lines
13 KiB
Objective-C
Executable File
224 lines
13 KiB
Objective-C
Executable File
//
|
||
// SPAlertController.h
|
||
// SPAlertController
|
||
//
|
||
// Created by 乐升平 on 18/10/12. https://github.com/SPStore/SPAlertController
|
||
// Copyright © 2018-2019 leshengping (lesp163@163.com). All rights reserved.
|
||
//
|
||
|
||
#import <UIKit/UIKit.h>
|
||
|
||
NS_ASSUME_NONNULL_BEGIN
|
||
|
||
typedef NS_ENUM(NSInteger, SPAlertControllerStyle) {
|
||
SPAlertControllerStyleActionSheet = 0, // 从单侧弹出(顶/左/底/右)
|
||
SPAlertControllerStyleAlert, // 从中间弹出
|
||
};
|
||
|
||
typedef NS_ENUM(NSInteger, SPAlertAnimationType) {
|
||
SPAlertAnimationTypeDefault = 0, // 默认动画，如果是SPAlertControllerStyleActionSheet样式,默认动画等效于SPAlertAnimationTypeFromBottom，如果是SPAlertControllerStyleAlert样式,默认动画等效于SPAlertAnimationTypeShrink
|
||
SPAlertAnimationTypeFromBottom, // 从底部弹出
|
||
SPAlertAnimationTypeFromTop, // 从顶部弹出
|
||
SPAlertAnimationTypeFromRight, // 从右边弹出
|
||
SPAlertAnimationTypeFromLeft, // 从左边弹出
|
||
|
||
SPAlertAnimationTypeShrink, // 收缩动画
|
||
SPAlertAnimationTypeExpand, // 发散动画
|
||
SPAlertAnimationTypeFade, // 渐变动画
|
||
|
||
SPAlertAnimationTypeNone, // 无动画
|
||
SPAlertAnimationTypeAlpha NS_ENUM_DEPRECATED_IOS(8_0, 8_0, "Use SPAlertAnimationTypeFade instead"), // 渐变动画
|
||
SPAlertAnimationTypeRaiseUp NS_ENUM_DEPRECATED_IOS(8_0, 8_0, "Use SPAlertAnimationTypeFromBottom instead"), // 从底部弹出
|
||
SPAlertAnimationTypeDropDown NS_ENUM_DEPRECATED_IOS(8_0, 8_0, "Use SPAlertAnimationTypeFromTop instead"), // 从顶部弹出
|
||
};
|
||
|
||
typedef NS_ENUM(NSInteger, SPAlertActionStyle) {
|
||
SPAlertActionStyleDefault = 0, // 默认样式
|
||
SPAlertActionStyleCancel, // 取消样式,字体加粗
|
||
SPAlertActionStyleDestructive // 红色字体样式
|
||
};
|
||
|
||
// ===================================================== SPAlertAction =====================================================
|
||
|
||
@interface SPAlertAction : NSObject <NSCopying>
|
||
|
||
+ (instancetype)actionWithTitle:(nullable NSString *)title style:(SPAlertActionStyle)style handler:(void (^ __nullable)(SPAlertAction *action))handler;
|
||
|
||
/** action的标题 */
|
||
@property(nullable, nonatomic, copy) NSString *title;
|
||
/** action的富文本标题 */
|
||
@property(nullable, nonatomic, copy) NSAttributedString *attributedTitle;
|
||
/** action的图标，位于title的左边 */
|
||
@property(nullable, nonatomic, copy) UIImage *image;
|
||
/** title跟image之间的间距 */
|
||
@property (nonatomic, assign) CGFloat imageTitleSpacing;
|
||
/** 渲染颜色,当外部的图片使用了UIImageRenderingModeAlwaysTemplate时,使用该属性可改变图片的颜色 */
|
||
@property (nonatomic, strong) UIColor *tintColor;
|
||
/** 是否能点击,默认为YES */
|
||
@property(nonatomic, getter=isEnabled) BOOL enabled;
|
||
/** action的标题颜色,这个颜色只是普通文本的颜色，富文本颜色需要用NSForegroundColorAttributeName */
|
||
@property(nonatomic, strong) UIColor *titleColor;
|
||
/** action的标题字体,如果文字太长显示不全，会自动改变字体自适应按钮宽度，最多压缩文字为原来的0.5倍封顶 */
|
||
@property(nonatomic, strong) UIFont *titleFont;
|
||
/** action的标题的内边距，如果在不改变字体的情况下想增大action的高度，可以设置该属性的top和bottom值,默认UIEdgeInsetsMake(0, 15, 0, 15) */
|
||
@property(nonatomic, assign) UIEdgeInsets titleEdgeInsets;
|
||
|
||
/** 样式 */
|
||
@property(nonatomic, readonly) SPAlertActionStyle style;
|
||
|
||
@end
|
||
|
||
// ===================================================== SPAlertController =====================================================
|
||
|
||
@protocol SPAlertControllerDelegate;
|
||
@interface SPAlertController : UIViewController
|
||
|
||
+ (instancetype)alertControllerWithTitle:(nullable NSString *)title message:(nullable NSString *)message preferredStyle:(SPAlertControllerStyle)preferredStyle;
|
||
+ (instancetype)alertControllerWithTitle:(nullable NSString *)title message:(nullable NSString *)message preferredStyle:(SPAlertControllerStyle)preferredStyle animationType:(SPAlertAnimationType)animationType;
|
||
|
||
- (void)addAction:(SPAlertAction *)action;
|
||
@property (nonatomic, readonly) NSArray<SPAlertAction *> *actions;
|
||
|
||
/* 添加文本输入框
|
||
* 一旦添加后就会回调一次(仅回调一次,因此可以在这个block块里面自由定制textFiled,如设置textField的属性,设置代理,添加addTarget,监听通知等);
|
||
*/
|
||
- (void)addTextFieldWithConfigurationHandler:(void (^ __nullable)(UITextField *textField))configurationHandler;
|
||
@property(nullable, nonatomic, readonly) NSArray<UITextField *> *textFields;
|
||
|
||
/** 主标题 */
|
||
@property(nullable, nonatomic, copy) NSString *title;
|
||
/** 副标题 */
|
||
@property(nullable, nonatomic, copy) NSString *message;
|
||
/** 主标题(富文本) */
|
||
@property(nullable, nonatomic, copy) NSAttributedString *attributedTitle;
|
||
/** 副标题(富文本) */
|
||
@property(nullable, nonatomic, copy) NSAttributedString *attributedMessage;
|
||
/** 头部图标，位置处于title之上,大小取决于图片本身大小 */
|
||
@property(nullable,nonatomic, copy) UIImage *image;
|
||
|
||
/** 主标题颜色 */
|
||
@property(nonatomic, strong) UIColor *titleColor;
|
||
/** 主标题字体,默认18,加粗 */
|
||
@property(nonatomic, strong) UIFont *titleFont;
|
||
/** 副标题颜色 */
|
||
@property(nonatomic, strong) UIColor *messageColor;
|
||
/** 副标题字体,默认16,未加粗 */
|
||
@property(nonatomic, strong) UIFont *messageFont;
|
||
/** 对齐方式(包括主标题和副标题) */
|
||
@property(nonatomic, assign) NSTextAlignment textAlignment;
|
||
/** 头部图标的限制大小,默认无穷大 */
|
||
@property (nonatomic, assign) CGSize imageLimitSize;
|
||
/** 图片的tintColor,当外部的图片使用了UIImageRenderingModeAlwaysTemplate时,该属性可起到作用 */
|
||
@property (nonatomic, strong) UIColor *imageTintColor;
|
||
|
||
/*
|
||
* action水平排列还是垂直排列
|
||
* actionSheet样式下:默认为UILayoutConstraintAxisVertical(垂直排列), 如果设置为UILayoutConstraintAxisHorizontal(水平排列)，则除去取消样式action之外的其余action将水平排列
|
||
* alert样式下:当actions的个数大于2，或者某个action的title显示不全时为UILayoutConstraintAxisVertical(垂直排列)，否则默认为UILayoutConstraintAxisHorizontal(水平排列)，此样式下设置该属性可以修改所有action的排列方式
|
||
* 不论哪种样式，只要外界设置了该属性，永远以外界设置的优先
|
||
*/
|
||
@property(nonatomic) UILayoutConstraintAxis actionAxis;
|
||
|
||
/* 距离屏幕边缘的最小间距
|
||
* alert样式下该属性是指对话框四边与屏幕边缘之间的距离，此样式下默认值随设备变化，actionSheet样式下是指弹出边的对立边与屏幕之间的距离，比如如果从右边弹出，那么该属性指的就是对话框左边与屏幕之间的距离，此样式下默认值为70
|
||
*/
|
||
@property(nonatomic, assign) CGFloat minDistanceToEdges;
|
||
|
||
/** SPAlertControllerStyleAlert样式下默认6.0f，SPAlertControllerStyleActionSheet样式下默认13.0f，去除半径设置为0即可 */
|
||
@property(nonatomic, assign) CGFloat cornerRadius;
|
||
|
||
/** 对话框的偏移量，y值为正向下偏移，为负向上偏移；x值为正向右偏移，为负向左偏移，该属性只对SPAlertControllerStyleAlert样式有效,键盘的frame改变会自动偏移，如果手动设置偏移只会取手动设置的 */
|
||
@property(nonatomic, assign) CGPoint offsetForAlert;
|
||
/** 设置alert样式下的偏移量,动画为NO则跟属性offsetForAlert等效 */
|
||
- (void)setOffsetForAlert:(CGPoint)offsetForAlert animated:(BOOL)animated;
|
||
|
||
/** 是否需要对话框拥有毛玻璃,默认为YES */
|
||
@property(nonatomic, assign) BOOL needDialogBlur;
|
||
|
||
/** 是否单击背景退出对话框,默认为YES */
|
||
@property(nonatomic, assign) BOOL tapBackgroundViewDismiss;
|
||
|
||
@property(nonatomic, weak) id<SPAlertControllerDelegate> delegate;
|
||
|
||
@property(nonatomic, readonly) SPAlertControllerStyle preferredStyle;
|
||
@property(nonatomic, readonly) SPAlertAnimationType animationType;
|
||
|
||
/** 设置action与下一个action之间的间距, action仅限于非取消样式，必须在'-addAction:'之后设置，iOS11或iOS11以上才能使用 */
|
||
- (void)setCustomSpacing:(CGFloat)spacing afterAction:(SPAlertAction *)action API_AVAILABLE(ios(11.0));
|
||
- (CGFloat)customSpacingAfterAction:(SPAlertAction *)action API_AVAILABLE(ios(11.0));
|
||
|
||
/** 设置蒙层的外观样式,可通过alpha调整透明度 */
|
||
- (void)setBackgroundViewAppearanceStyle:(UIBlurEffectStyle)style alpha:(CGFloat)alpha;
|
||
|
||
// 插入一个组件view，位置处于头部和action部分之间，要求头部和action部分同时存在
|
||
- (void)insertComponentView:(nonnull UIView *)componentView;
|
||
|
||
|
||
// ---------------------------------------------- custom -----------------------------------------------------
|
||
/**
|
||
创建控制器(自定义整个对话框)
|
||
|
||
@param customAlertView 整个对话框的自定义view
|
||
@param preferredStyle 对话框样式
|
||
@param animationType 动画类型
|
||
@return 控制器对象
|
||
*/
|
||
+ (instancetype)alertControllerWithCustomAlertView:(nonnull UIView *)customAlertView preferredStyle:(SPAlertControllerStyle)preferredStyle animationType:(SPAlertAnimationType)animationType;
|
||
/**
|
||
创建控制器(自定义对话框的头部)
|
||
|
||
@param customHeaderView 头部自定义view
|
||
@param preferredStyle 对话框样式
|
||
@param animationType 动画类型
|
||
@return 控制器对象
|
||
*/
|
||
+ (instancetype)alertControllerWithCustomHeaderView:(nonnull UIView *)customHeaderView preferredStyle:(SPAlertControllerStyle)preferredStyle animationType:(SPAlertAnimationType)animationType;
|
||
/**
|
||
创建控制器(自定义对话框的action部分)
|
||
|
||
@param customActionSequenceView action部分的自定义view
|
||
@param title 大标题
|
||
@param message 副标题
|
||
@param preferredStyle 对话框样式
|
||
@param animationType 动画类型
|
||
@return 控制器对象
|
||
*/
|
||
+ (instancetype)alertControllerWithCustomActionSequenceView:(nonnull UIView *)customActionSequenceView title:(nullable NSString *)title message:(nullable NSString *)message preferredStyle:(SPAlertControllerStyle)preferredStyle animationType:(SPAlertAnimationType)animationType;
|
||
|
||
/** 更新自定义view的size，比如屏幕旋转，自定义view的大小发生了改变，可通过该方法更新size */
|
||
- (void)updateCustomViewSize:(CGSize)size;
|
||
|
||
@property(nonatomic, assign) CGFloat cornerRadiusForAlert NS_DEPRECATED_IOS(8_0, 8_0,"Use cornerRadius instead");
|
||
@property (nonatomic, assign) CGFloat maxTopMarginForActionSheet NS_DEPRECATED_IOS(8_0, 8_0,"Use minDistanceToEdges instead");
|
||
@property(nonatomic, assign) CGFloat maxMarginForAlert NS_DEPRECATED_IOS(8_0, 8_0,"Use minDistanceToEdges instead");
|
||
@property(nonatomic, assign) NSInteger maxNumberOfActionHorizontalArrangementForAlert NS_DEPRECATED_IOS(8_0, 8_0,"Use actionAxis instead");
|
||
@property(nonatomic, assign) CGFloat offsetYForAlert NS_DEPRECATED_IOS(8_0, 8_0,"Use offsetForAlert instead");
|
||
+ (instancetype)alertControllerWithTitle:(nullable NSString *)title message:(nullable NSString *)message preferredStyle:(SPAlertControllerStyle)preferredStyle animationType:(SPAlertAnimationType)animationType customView:(nullable UIView *)customView NS_DEPRECATED_IOS(8_0, 8_0,"Use +alertControllerWithCustomAlertView:preferredStyle:animationType:");
|
||
+ (instancetype)alertControllerWithPreferredStyle:(SPAlertControllerStyle)preferredStyle animationType:(SPAlertAnimationType)animationType customHeaderView:(nullable UIView *)customHeaderView NS_DEPRECATED_IOS(8_0, 8_0,"Use +alertControllerWithCustomHeaderView:preferredStyle:animationType:");
|
||
+ (instancetype)alertControllerWithTitle:(nullable NSString *)title message:(nullable NSString *)message preferredStyle:(SPAlertControllerStyle)preferredStyle animationType:(SPAlertAnimationType)animationType customCenterView:(nullable UIView *)customCenterView NS_DEPRECATED_IOS(8_0, 8_0,"Use -insertComponentView:");
|
||
+ (instancetype)alertControllerWithTitle:(nullable NSString *)title message:(nullable NSString *)message preferredStyle:(SPAlertControllerStyle)preferredStyle animationType:(SPAlertAnimationType)animationType customFooterView:(nullable UIView *)customFooterView NS_DEPRECATED_IOS(8_0, 8_0,"Use +alertControllerWithCustomActionSequenceView:title:message:preferredStyle:animationType:");
|
||
@end
|
||
|
||
@protocol SPAlertControllerDelegate <NSObject>
|
||
@optional;
|
||
- (void)willPresentAlertController:(SPAlertController *)alertController; // 将要present
|
||
- (void)didPresentAlertController:(SPAlertController *)alertController; // 已经present
|
||
- (void)willDismissAlertController:(SPAlertController *)alertController; // 将要dismiss
|
||
- (void)didDismissAlertController:(SPAlertController *)alertController; // 已经dismiss
|
||
|
||
|
||
- (void)sp_alertControllerWillShow:(SPAlertController *)alertController NS_DEPRECATED_IOS(8_0, 8_0,"Use -willPresentAlertController:");
|
||
- (void)sp_alertControllerDidShow:(SPAlertController *)alertController NS_DEPRECATED_IOS(8_0, 8_0,"Use -DidPresentAlertController:");
|
||
- (void)sp_alertControllerWillHide:(SPAlertController *)alertController NS_DEPRECATED_IOS(8_0, 8_0,"Use -willDismissAlertController:");
|
||
- (void)sp_alertControllerDidHide:(SPAlertController *)alertController NS_DEPRECATED_IOS(8_0, 8_0,"Use -DidDismissAlertController:");
|
||
@end
|
||
|
||
@interface SPAlertPresentationController : UIPresentationController
|
||
@end
|
||
|
||
@interface SPAlertAnimation : NSObject <UIViewControllerAnimatedTransitioning>
|
||
+ (instancetype)animationIsPresenting:(BOOL)presenting;
|
||
@end
|
||
|
||
NS_ASSUME_NONNULL_END
|