text: //
  //  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>
  
  @class SPAlertController;
  
  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 SPAlertStyle : NSObject
  + (instancetype)sharedInstance;
  @property(nonatomic, assign) CGFloat lineWidth;
  @property(nonatomic, assign) CGFloat actionHeight;
  @property(nonatomic, assign) CGFloat headerActionLineWidth;
  @end
  
  @interface SPAlertAction : NSObject <NSCopying>
  
  + (instancetype)actionWithTitle:(nullable NSString *)title style:(SPAlertActionStyle)style handler:(void (^ __nullable)(SPAlertAction *action, SPAlertController *alertController))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
  