tnomg/hwpanmodal

HWPanModal presents controller from bottom and drag to dismiss, high customize.

HWPanModal 👍

HWPanModal is used to present controller and drag to dismiss.

Inspired by PanModal, thanks.

中文文档说明

My another project for pop controller:HWPopController

Snapshoot

Basic	Blur background	Keyboard handle	App demo

Features

1. Supports any type of UIViewController
2. Seamless transition between modal and content
3. Support two kinds of GestureRecognizer
   1. UIPanGestureRecognizer, direction is UP & Down.
   2. UIScreenEdgePanGestureRecognizer, you can swipe on screen edge to dismiss controller.
4. Support write your own animation for presenting VC.
5. Support config animation Duration, AnimationOptions, springDamping.
6. Support config background alpha or blur background. Note: Dynamic change blur effect ONLY works on iOS9.0+.
7. Show / hide corner, indicator.
8. Auto handle UIKeyboard show/hide.
9. Hight customize indicator view.

More config pls see HWPanModalPresentable.h declare.

TODO

• Handle keyboard show&dismiss.
• High customize indicator view.
• Touch event can response to presenting VC.

Compatibility

iOS 8.0+, support Objective-C & Swift.

Dependency

KVOController - facebook

Because Objective-C KVO is hard to use, so I use KVOController = =

Installation

CocoaPods

pod 'HWPanModal', '~> 0.3.4'

How to use

How to present from bottom

Your UIViewController need to conform HWPanModalPresentable. If you use default, nothing more will be written.

#import <HWPanModal/HWPanModal.h>
@interface HWBaseViewController () <HWPanModalPresentable>

@end

@implementation HWBaseViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    // Do any additional setup after loading the view.
}

#pragma mark - HWPanModalPresentable
- (PanModalHeight)longFormHeight {
    return PanModalHeightMake(PanModalHeightTypeMaxTopInset, 44);
}
@end

Where you need to present this Controller.

#import <HWPanModal/HWPanModal.h>
[self presentPanModal:[HWBaseViewController new]];

yeah! Easy.

Change state, scrollView contentOffset, reload layout

When You present you Controller, you can change the UI. Refer to UIViewController+Presentation.h.

• Change the state between short and long form. call - (void)hw_panModalTransitionTo:(PresentationState)state;
• Change ScrollView ContentOffset. call - (void)hw_panModalSetContentOffset:(CGPoint)offset;
• Reload layout. call - (void)hw_panModalSetNeedsLayoutUpdate;
  • Note: When your scrollable changed it's contentSize, you MUST reload the layout.

Custom Presenting VC Animation

Some guys want to animate Presenting VC when present/dismiss.

1. Create object conforms HWPresentingViewControllerAnimatedTransitioning .

   @interface HWMyCustomAnimation : NSObject <HWPresentingViewControllerAnimatedTransitioning>
   
   @end
   
   @implementation HWMyCustomAnimation
   
   
   - (void)presentAnimateTransition:(id<HWPresentingViewControllerContextTransitioning>)transitionContext {
       NSTimeInterval duration = [transitionContext mainTransitionDuration];
       UIViewController *fromVC = [transitionContext viewControllerForKey:UITransitionContextFromViewControllerKey];
       // replace it.
       [UIView animateWithDuration:duration delay:0 usingSpringWithDamping:0.8 initialSpringVelocity:0 options:UIViewAnimationOptionCurveEaseInOut animations:^{
           fromVC.view.transform = CGAffineTransformMakeScale(0.95, 0.95);
       } completion:^(BOOL finished) {
           
       }];
   }
   
   - (void)dismissAnimateTransition:(id<HWPresentingViewControllerContextTransitioning>)transitionContext {
       NSTimeInterval duration = [transitionContext mainTransitionDuration];
       UIViewController *toVC = [transitionContext viewControllerForKey:UITransitionContextToViewControllerKey];
       // replace it.
       [UIView animateWithDuration:duration animations:^{
           toVC.view.transform = CGAffineTransformIdentity;
       }];
   }
   
   @end

2. Overwrite below two method.

   - (BOOL)shouldAnimatePresentingVC {
       return YES;
   }
   
   - (id<HWPresentingViewControllerAnimatedTransitioning>)customPresentingVCAnimation {
       return self.customAnimation;
   }
   
   - (HWMyCustomAnimation *)customAnimation {
       if (!_customAnimation) {
           _customAnimation = [HWMyCustomAnimation new];
       }
       return _customAnimation;
   }

Custom your own indicator view

You just need to create your own UIView, then adopt HWPanModalIndicatorProtocol.

In your presented controller, return it:

- (nullable UIView <HWPanModalIndicatorProtocol> *)customIndicatorView {
    HWTextIndicatorView *textIndicatorView = [HWTextIndicatorView new];
    return textIndicatorView;
}

Here is HWTextIndicatorView code:

@interface HWTextIndicatorView : UIView <HWPanModalIndicatorProtocol>

@end

@interface HWTextIndicatorView ()
@property (nonatomic, strong) UILabel *stateLabel;
@end

@implementation HWTextIndicatorView

- (instancetype)initWithFrame:(CGRect)frame {
    self = [super initWithFrame:frame];
    if (self) {
        // init the _stateLabel
        [self addSubview:_stateLabel];
    }
    return self;
}


- (void)didChangeToState:(HWIndicatorState)state {
    switch (state) {
        case HWIndicatorStateNormal: {
            self.stateLabel.text = @"Please pull down to dismiss";
            self.stateLabel.textColor = [UIColor whiteColor];
        }
            break;
        case HWIndicatorStatePullDown: {
            self.stateLabel.text = @"Keep pull down to dismiss";
            self.stateLabel.textColor = [UIColor colorWithRed:1.000 green:0.200 blue:0.000 alpha:1.00];
        }
            break;
    }
}

- (CGSize)indicatorSize {
    return CGSizeMake(200, 18);
}

- (void)setupSubviews {
    self.stateLabel.frame = self.bounds;
}

@end

Example

1. Clone this git.
2. open the terminal, run pod install
3. Double click HWPanModal.xcworkspace, and run.

Contact Me

Heath Wang [email protected]

Change Log

Click Me

License

HWPanModal is released under a MIT License. See LICENSE file for details.