featherVoice/QXLive/Third/HWPopController/Classes/Controller/HWPopController.h

//
//  HWPopController.h
//  HWPopController
//
//  Created by heath wang on 2019/5/21.
//

#import <Foundation/Foundation.h>
#import "HWPopControllerAnimationProtocol.h"

NS_ASSUME_NONNULL_BEGIN

typedef NS_ENUM(NSInteger, HWPopPosition) {
	HWPopPositionCenter,
	HWPopPositionTop,
	HWPopPositionBottom,
};

typedef NS_ENUM(NSInteger, HWPopState) {
    HWPopStatePop,      // present
    HWPopStateDismiss,  // dismiss
};

typedef NS_ENUM(NSInteger, HWPopType) {
    HWPopTypeNone,
    HWPopTypeFadeIn,
    HWPopTypeGrowIn,
    HWPopTypeShrinkIn,
    HWPopTypeSlideInFromTop,
    HWPopTypeSlideInFromBottom,
    HWPopTypeSlideInFromLeft,
    HWPopTypeSlideInFromRight,
    HWPopTypeBounceIn,
    HWPopTypeBounceInFromTop,
    HWPopTypeBounceInFromBottom,
    HWPopTypeBounceInFromLeft,
    HWPopTypeBounceInFromRight,
};

typedef NS_ENUM(NSInteger, HWDismissType) {
    HWDismissTypeNone,
    HWDismissTypeFadeOut,
    HWDismissTypeGrowOut,
    HWDismissTypeShrinkOut,
    HWDismissTypeSlideOutToTop,
    HWDismissTypeSlideOutToBottom,
    HWDismissTypeSlideOutToLeft,
    HWDismissTypeSlideOutToRight,
    HWDismissTypeBounceOut,
    HWDismissTypeBounceOutToTop,
    HWDismissTypeBounceOutToBottom,
    HWDismissTypeBounceOutToLeft,
    HWDismissTypeBounceOutToRight,
};

@interface HWPopController : NSObject

#pragma mark - config properties

/**
 //////////////////////////////////////////////////////
 Below props should be set when you pop the controller.
 //////////////////////////////////////////////////////
 */

/**
 * pop animation style
 * default is HWPopTypeGrowIn
 */
@property (nonatomic, assign) HWPopType popType;
/**
 * dismiss animation style
 * default is HWDismissTypeFadeOut
 */
@property (nonatomic, assign) HWDismissType dismissType;
/**
 * animation duration
 * default is 0.2 s
 */
@property (nonatomic, assign) NSTimeInterval animationDuration;
/**
 * The pop view final position.
 * Default is HWPopPositionCenter
 */
@property (nonatomic, assign) HWPopPosition popPosition;
/**
 * The offset of the pop view.
 */
@property (nonatomic, assign) CGPoint positionOffset;
/**
 * You can custom your own animation for pop and dismiss.
 * once you set this property, and NOT nil,
 * the `popType` and `dismissType` will be ignore.
 */
@property (nonatomic, weak) id<HWPopControllerAnimationProtocol> animationProtocol;
@property (nonatomic, assign) UIEdgeInsets safeAreaInsets;

/**
 //////////////////////////////////////////////////////
 Below props can be set when you need.
 //////////////////////////////////////////////////////
 */

/**
 * The background when popup. You can set it as `UIImageView`, `UIVisualEffectView` such as.
 */
@property (nullable, nonatomic, strong) UIView *backgroundView;
/**
 * pop background alpha.
 * default is 0.5
 */
@property (nonatomic, assign) CGFloat backgroundAlpha;
/**
 * determine touch background to dismiss
 * Default is YES.
 */
@property (nonatomic, assign) BOOL shouldDismissOnBackgroundTouch;

/// Default is YES
@property (nonatomic, assign) BOOL shouldAutoHandleKeyboardEvent;

#pragma mark - readonly properties

/**
 * Hold the pop view container.
 * Default the backgroundColor is White.
 * Default the corner radius is 8.0f.
 * If you want to custom corner, change containerView layer.
 */
@property (nonatomic, strong, readonly) UIView *containerView;
/**
 * Which view the popped ViewController view added.
 */
@property (nonatomic, strong, readonly) UIView *contentView;

/**
 * topViewController is the viewController which is presented.
 */
@property (nonatomic, strong, readonly) UIViewController *topViewController;
@property (nonatomic, assign, readonly) BOOL presented;

/**
 * init PopController
 * @param presentedViewController the controller which will be presented
 */
- (instancetype)initWithViewController:(UIViewController *)presentedViewController;

/**
 * pop controller
 * @param presentingViewController which controller to present.
 */
- (void)presentInViewController:(UIViewController *)presentingViewController;

- (void)presentInViewController:(UIViewController *)presentingViewController completion:(nullable void (^)(void))completion;

- (void)dismiss;

- (void)dismissWithCompletion:(nullable void (^)(void))completion;

- (void)layoutContainerView;

@end

NS_ASSUME_NONNULL_END